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Dilwyn Jones 


Here we are in 2004, 20 years after the launch of the QL, as Urs 
K6nig recently reminded us via the QL mailing list: 


"On January 12th 1984 (exactly 12 days earlier than Steve Jobs 
lauched the Apple Macintosh) Sir Clive Sinclair presented the QL 
professional computer to the world in a hollywood-style event at 
the Intercontinental Hotel, Hyde Park Corner, London.” 


20 years on and we have such QLing delights as colour drivers, 
Q60s, various QL emulators, net access, graphical user interfaces 
and so on, many things we could only have dreamed of years ago. 
Just what is it about QDOS and SMSQ that keeps us going after 20 
years! 


One of the latest developments is the new Window Manager and 
software designed to ease the use of the colurs, such as QCoco 
by Wolfgang Uhlig. Wolfgang has an interesting article about getting 
hi-colours in Easymenu. All this contributes towards the maturity and 
usability of the new colours. 


It looks like there will be a busy QL show season this year Plans 
have been made for a large QL2004 show later in the year and 
there will be several other shows during the year as well. The USA 
QL show now has its own website - see elsewhere in this issue. 


There are changes afoot at Quanta. Unfortunately, the new editor 
got off to an unfortunate start, with problems delaying his first issue, 
resulting in the eventual production of only a single issue to span 3 
or months, and to top that the Chairman and Secretary are to step 
down this year after several years of much valued contribution. It is 
to be hoped that Quanta will be able to appoint enthusiastic new 
Officials to carry the group forward to the future. 


Happy QLing to you all in 2004! 


THE MODERN GL WEDDING 


"LDitTH THis SERNET 
CABLE, | THEE WED...” 
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QCoCo 

Wolfgang Uhlig writes: 

QCoCo is now version 1.5. It has integrated the 
new bmpcvt-extensions by W. Lenerz which 
make background images look fine on the 
Q40/60, too. It is compiled and has a config block 
level 2, which makes configuration much easier. 
The RGB colour-mixer is integrated now, more 
compact and convenient. If you use QCoCo, it 
must be be said that despite the possibility to 
apply lots of 3D-borders you can't take any bor- 
der anywhere! The Qpac2- and QMenu-menus 
are of fixed sizes and if you give them borders 
that are not QL-compatible, you might experience 
strange behaviour Please avoid therefore to give 
an Application Window a 3D-border from 1030 up 
to 1039. This is the entire last row and the first 
and last button of the first row in the border-table 
in QCoCo. 

| shall redesign this table to make it clearer, when | 
have the time. Also | heard of people having 
strange crashes or half drawn windows. This has 
to do with older WMAN-stuff that is loaded in the 
bootfile. Please look that only SMSQ/E 3.04 is 
used and no other WMAN-extensions. Another 
user told me of a possible problem with the older 
version of bmpcvt-extension of W. Lenerz. There 
is a new version in order to make bitmaps look 
fine on a Q40/60, too, and QCoCo has this al- 
ready integrated. | cannot reproduce this problem 
on my machine, because both versions run 
together without problems, but you could check 
this, if there are problems. | am aware of the fact 
that the older version is needed to run Qcolour, 
the RGB-mixer. But first, as | said, on my machine 
both run fine and second, there will be a new 
RGB-picker in a short time, | have already started 
to design it. Again, Marcel provided me with an 
extension which will make that possible. QCoco 
can be downloaded at: www.uhlich.nl/ql/qcoco.zip 


Editor News 

Mark Knight 

Mark has been working on Editor again, promp- 
ted partly by George Gwilt. George informed him 
that Editor's method of finding out how much free 
memory was present was not compatible with 
latest versions of SMSQ/E running on some hard- 
ware with stacks of RAM, so it needed a 
compatibility update. Editor did still work on these 
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systems but couldn't use all the memory present. 
George also provided a sequence which could be 
typed into Editor to reliably reproduce the one 
known bug left in it, plus some information that 
tied it down to an initialisation bug. Once Mark had 
the ability to reproduce the bug and the extra in- 
formation it actually took less than half an hour to 
pin it down and fix it. 

In order that the new version can be used the 
latest Turbo Toolkit is needed, this is in the .ZIP file 
on Mark's web site so you get it when you 
download, just do remember to install it. Those 
who want to link the toolkit into the executable, 
Q-Liberator style, will need the source code and 
the latest Turbo compiler, available elsewhere. The 
ZIP files need to be ported across to your QL or 
SMSQ/E system and unzipped there, or get the 
disks from a QL public domain trader once they 
have downloaded the files. Mark's web site is at: 
http://www.the-furnace.demon.co.uk 


and the Editor 3.07K is on the "QL Stuff” page. 
So that it is easy to distinguish the program from 
previous versions it announces itself as “Editor 
2004’ on the start-up screen. By all means visit 
other pages on the web site, particularly the art 
galleries if you like pencil drawing or computer 
graphics artwork. 


USA QL Show 2004 Website 

Jim Hunkins writes: 

The web site for the US QL Show 2004 is now on 
line at: 

http://www.jdh-stech.com/ql-usashow.htm 

If you are thinking or planning on attending, 
please let us know as soon as possible and also 
get your reservations in as | understand that 
Florida is fairly busy that time of year. 

| have included a fairly extensive travel page with 
all kinds of links to transportation, motel reserva- 
tions, and area things to do for your convenience. 
You might also note that the email links will all 
require Java 11 or later (anti-spam encoded) but 
you can also pick up the addresses from the 
graphics on the contacts page. 

Enjoy and looking forward to seeing you all there! 
Thanks to Phoebus Dokos, we have added seve- 
ral new items to the QL USA Show schedule on 
the web, along with some additional updates. We 
are now showing that we will have 6 exhibitors, 
four from Europe. Please take a look at the site 
and let me know of any changes, if you plan to 
attend (and if we can list you), if you plan to exhibit 
and aren't yet listed, and any ideas or volunteer- 
ing for more demos/talks, etc. 

Also, watching the recent thread for the QL 2004 
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(on ql-users email mailing list), | have added tenta- 
tively some kind of panel discussion. | do recall 
that they have always been popular at previous 
shows. 


BMP2SPRT 

Wolfgang Lenerz has written a small QL program 
to convert PC bitmaps into QL sprites. 

You can find vi.t0 of BMP2SPRT on Wolfgang 
Lenerz's website: 
www.scp-paulet-lenerz.com/14mljkl24/Wolf/download 
Also, please note Wolfgang's new email address 
wolf@scp-paulet-lenerz.com 


SMSQ/E Sources Website 

Please note that the SMSQ/E sources may be 
obtained at the following website: 
www.scp-paulet-lenerz.com/smsqe 

The site is still under construction, so please be 
patient. It is forseen to include the following for 
download: 

individual directories within the sources “upgrade” 
package from one version to another (but only 
from version x.xx to version x.xx + 1) 


IFE Liorary News 

Javier Guerra writes: 

Thanks to the work of Miguel Angel Hernandez 
and Salvador Merino, it’s available now, on the 
internet, the discs of the IFE library at: 
http://homepage.mac.com/miguelahernandez1/ 
Education14.html 

and 
http://homepage.mac.com/WebObjects/FileSharing.woa/1/ 
wo/ahfv6UZcIRbifeRS.1/0.2.1.2.22.31.97.1.35.0.1.1.1? 
user=miguelahernandez1 &fpath=|FE%20Library& 
templatefn=FileSharing1.html 

The Independent Spanish Users Club of Sinclair 
QL (CEIUQL) (1985-1997), known also as QLAVE 
(who sounds as ‘clave’ in Spanish, and means 
“key” or response’), was a member of IFE (Inter- 
group Freeware Exchange), a kind of Federation of 
International Clubs whose only objective was to 
create a great library of free QL software. 


Q-Emulator News 

by Daniele Terdina 

Just a quick note that Q-emuLator 2.3.1 is availa- 
ble at http://users.infoconex.com/daniele/winal.htm! 

This is a minor update adding more TCP/IP func- 
tionality (needed for email and FTP) and a fix for a 
bug affecting the PAR device on Windows XPAs 
always, the update is available for free to all 
registered users. 
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Text87 News 

Jochen Merz 

text87, one of the few programs which does not 
run properly in high-colour mode can now be 
modified to work in 16-bit colours on the QXL and 
QPC (with SMSQ/E Version 3). Marcel Kilgus has 
added a new driver for this program which will be 
added to the program and enable you to run it 
nicely in high-colour mode. You have two options: 
it can look the same way as before (white/red/ 
green on black) or - much better looking - 
colours on a nice grey. It is up to you, you can try 
both settings. 

text87plus4 PATCH is available now from J-M-S 
for only EUR 12,- including postage & packaging! 
Easy-to-use, will it provide you with a text87 
which works without having to re-start QPC in a 
different colour mode or use a DISP_COLOUR 0 
which will screw up the rest of the display. No, 
with text87plus4 PATCH it will work without the 
need to change display resolution - and we think 
it looks even better in grey! 

Please note: the PATCH program requires you to 
own the latest version of text87plus4 English (E4), 
file size 116850 bytes or the latest version of 
text87plus4 German (94), file size 117354. 

You do not need to configure or modify the result 
of using text87plus4 PATCH-just execute this one 
instead of your original program! 

Please note: the Patch is sold with the permission 
of text87 author Fred Toussi. Currently, it only 
works on QXL and QPC in high-colour mode (not 
8 bit) and not on GC and Qx0 either Depending 
on the interest, Marcel may consider implementing 
more screen drivers and modes. 

You can now find a secure contact form on the 
J-M-S homepage (smsq.j-m-s.com), where you can 
submit credit card data etc. without having to 
send it via email. 


News from Marcel Kilgus 

Just a quick note that | have updated my pages at 
wwwkilgus.net with a new "SMSQ/E" section that 
includes various new stuff that is not directly 
related to QPC, like my WMAN theme, various 
updated applications and a Windows program 
that converts PNG images to SMSQ/E sprites 
(most new sprites in SMSQ/E and the JMS collec- 
tion have been converted using this program 
after being created with Photoshop as it also 
handles the alpha channel correctly). 


CYBIKO PDA Driver for QDOS 
Simon has written a QDOS driver for a Cybiko. A 


Cybiko is a nifty cheap Russian PDA - one of the 
few around that still uses a RS232 serial cable to 
link to a PC/Mac (and now a QL, thanks to Simon) 
instead of USB. They are available in 3 colours, 
and cost just 20 pounds sterling each - dirt 
cheap, considering what you get. 

see www.cybiko.com 

They can email and internet when connected to a 
PC/Mac, they can text message other cybikos 
for free, and they can download and install appli- 
cations, including a word processor - an applica- 
tion CD costs just five pounds! 


QL Documentation Online 

by Dilwyn Jones 

| have now put much of the QL Documentation 
CD online on my TopCities website. Either go to 
the normal Tesco.Net site 
http://homepages.tesco.net/dilwyn.jones/index.html 

and click on the new link at the bottom of the 
page or go direct to the site on 
http://dilwynjones.topcities.com/index.htm 

and click on the QL Manuals & Documentation 
page link. There's all sorts of useful articles, 
replacement manuals and QL-related documents 
there. 

Not all of the material is there yet, but it's a huge 
improvement on what | was able to put onto the 
Tesco.net site because of space limitations. 
Anyone with additional material to put online is 
welcome to send it to me for inclusion. | hope this 
will prove to be a valuable online resource of QL 
related documentation and information. 

This site also hosts a large amount of old 
QL-zines (back issues of Club QL International 
newsletters, QL-Forum, QL Hackers & Linux Jour- 
nals, Italian magazines and in due course a pointer 
to the Spanish QL Resources site to access the 
Spanish QL newsletters too), as well as being the 
new home of the QL Rogues Page, Pictures of QL 
related equipment you can use for creating your 
own websites, the QL Humour page (including the 
complete collection of QL Today cartoons) and 
the back issues of the QL Today cover disks. 


LAUNCHPAD V0.96 

Launchpad has now been updated to v0.96. 
Below is a list of new and updated features in this 
version (the first paragraph refers to changes in 
version 0.95 - the version number is shown in the 
Copyright menu or while you configure the 
program). 

Launchpad now only does an RJOB "CLOCK’ if 
the Launchpad clock is active, in order to prevent 
the unintentional removal of other jobs with the 
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name ‘clock’ such as the QPACI clock program. 
The MyQL menu now uses EX to start Q-Trans 
rather than EW, to allow you to CTRL C between 
Q-Trans and Launchpad if required. Desktop menu 
names now default to Menu 1, Menu 2, Menu 3 
and Menu 4. 

Added Jobs menu, identical to Utility-Pick/ 
Remove A Program, but quicker to access. Made 
sense since launching a program is so quick and 
easy, but Pick or Remove a job is a bit more long 
winded in older versions. 

Updates from earlier versions are free of charge 
(see previous issue's news page for details). 

For Qlers in Germany, Austria or Switzerland, 
Launchpad may now be ordered via Jochen Merz 
Software if preferred. Customers wishing to pay in 
Euros should preferably order from Q-Celt Com- 
puting outside those areas. 


QL Today Index 

Timothy Swenson has produced a QL Today 
Index covering the volumes after volume 4 (my 
original index only covers the first few volumes). 
The index is currently in Excel v5.0 format, though 
it should be possible to export this into text or 
CSV format, for example. By the time you read 
this, | should have been able to add this to my 
website and PD library. 


PD Library News 

Dilwyn Jones 

My PD library now consists of 167 disk of general 
QL PD software. Recent changes are as follows: 


disk GE163: 

Mark Knight Utilities disk of programs, snippets 
and useful toolkit-style extension files. The pro- 
grams include: Auto Indent Program / BList, 
SuperBASIC Listing program / CONFIGURE / 
Condense, the SuperBASIC/SBASIC file conden- 
ser / File Manager version / Printer Install Program 
/ QL character set editor QuickSet / QL Super 
Alarm program 


disk GE164: 

Floppy Disk Utilites vi22 from Ergon 
Development. Especially designed for the (Super) 
Gold Card user This program supports DD, HD 
(144 MB) and ED disks (3.2 MB). Disk editor 
single/multiple disk copier / formatter / verifier. It 
works also with a single disk drive. File recover, 
Search, Collect, Print sectors. You can also format 
disks with an extra 5% capacity (a bonus of 
160KB with ED disks). If you have a 3.2MB or 
1.44MB disk drive this program could be very 
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useful (SMS2+QVME compatible). The manual is 
included (Italian and English language) in Quill 
format. PopCalc - a popup calculator program 
from Mark Knight. SetDate - set the QL clock 
effortlessly with this utility Shrink - Memory 
Shrink v2.50, reset a QL to a given memory size. 
Super Kit Merger - merge your extensions as 
one toolkit. Soft Eprom v1.00 - Save ROM images 
to file to be run from RAM. Tools v1.07 - a 
head-up display of date, time, caps lock, etc. 
Touchit - programmable keys v2.15 


disk GE165: 

TextTools, supplement to GNU Text Utilities - see 
disks GE118/9. This package is version 1.1, ported 
by Franz Krojer. 


disk GE166: 

(4 disks) PGP v2.6i - Pretty Good Privacy 
encryption software, ported for QL by Jonathan 
Hudson. 


GE167: 

Recover - Archive database recovery program. 
BASIC version included. ResQL - Hans Lub’'s 
program for recovering damaged files or floppy 
disks. Sector Editor - Sector editor for DD floppy 
disks, by Graham Underwood. Unzip Librarian - 


Pointer driven and non-pointer driven versions of 
a front end program for QL unzip. Helps make use 
of Unzip that little bit easier! Universal Turing 
Machine simulator, by Kevin Betts. Utilities - a set 
of short programs by Per Erik Forssen. Includes 
Clock vi.26, ESCstrip vi.04, Disk Re-labeller v1.00, 
OpenFile v0.05, Snapshot v0.01. 


EPSON Printer Codes 

Dilwyn Jones 

| have prepared a reference document of Epson 
printer control codes, using the standard Epson 
ESC/P 2 documentation supplied on my QL 
Documentation CD. The snag with the Epson PDF 
files is the sheer size, several megabytes and you 
need the Adobe PDF file reader programs to read 
them. My document is a cut-down document, in 
Quill format. It will be short enough to email or 
place on my website when complete (nearly 
complete at the time of writing) alongside the 
existing HP PCL printer documentation. 


Please send any QL-related 
news you would like to see 


published here to 
Editor@qltoday.com 


WU 


JUST WORDS! 


The final countdown... 


QTYP dictionaries: 


Danish - 23,515 words 

Dutch - 180,130 words 

French - 208,913 words 
German - 165,935 words 
Italian - 83,829 words 
Norwegian - 61,413 words 
Spanish - 174,846 words 
Swiss German - 165,810 words 
UK English - 82,098 words 
USA English - 77,722 words 


£1 or €1.5 EACH 


Programs: 
QL-2-PC TRANSFER 
QL-RHYMES 
AUTO-GRAPH 


£10 or €15 EACH 


Plus: 
VOCABULARY DATABASE 
£5 OR €7.50 


Geoff Wicks, 56 Peveril Crescent, West Hallam, Derbyshire DE7 6ND, U.K. 


Tel: +44 (0)115 - 930 3713 


email: gwicks@beeb.net 


Web: http://members.lycos.co.uk/geoffwicks/justwords.htm 
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Colours with EasyMenu 


(with special regard to the new 


system Colours) 
Wolfgang Uhlig 


In the last QL-Today Geoff Wicks wrote some 
comments on a review of one of his programs. 
One of the statements was that EasyPtr is unable 
to use the new colour drivers. Have a look at my 
programs QColour, MfColour and QCoCo and you 
will know that this is not true. The truth is: you 
cannot use the new colours when designing 
menus inside Easymenu (and even this is no 
longer completely true, because you can use the 
new colour sprites, see below), but you can make 
EasyPtr programs use the colours without nearly 
any limit! And that's what this article is about. It's 
written for people who already know how to 
design menus in EasyMenu, to append menus 
and sprites to an appendix-file and to write a 
slightly advanced EasyPtr-program. | recommend 
that beginners first read the articles about Easy- 
Ptr-programming | wrote in former editions of QL- 
Today. Also | want to give some explanations 
about the new system colours from the point of 
view of somebody who has no assembler pro- 
gramming skills at all and only little understanding 
of bits, bytes, hexcodes etc. | think that there are 
more people among the QL-community like me 
and | want them to profit from what | have learnt 
while | was programming QCoCo, the new sys- 
tem-colour-configurator One of my_ essential 
“knowledge sources” was Marcel Kilgus to whom 
| am deeply indebted (to take Geoff's beautiful ex- 
pression). 

The trick is actually very simple: EasyPtr allows 
you to make any window the active window and 
accept all graphic commands like PAPER, INK, 
BLOCK, BORDER etc. by the command: 
MWINDOW. So you may also use the new 
system-colour commands WM_PAPER, WM_INK, 
WM_BORDER, WM_BLOCK etc. The most con- 
venient windows to handle are Information Win- 
dows (from now on: IfW) and Application 
Windows (AppW). But also Loose Items (LI) can 
get colours but have to be handled a Ittle bit 
differently. 


IfWs (which can even overlap each other) are not 
checked in a MCALL-routine and keep their 
colour information throughout the whole program 
loop. It's enough to give them a colour in the very 
begin of the program. So the command 

MWINDOW #3,1! : WM_PAPER #3,32799 : CLS #3 
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will give the first IW in your program (which has 
opened a con_ channel 3) the colour blue and this 
will remain as long as you don't give it another 
colour or close the program. If you have 
overlapping IfWs, you have to define the windows 
in the correct sequence, the last defined will 
always be on the top. The only drawback is that 
you cannot use the Info Objects any longer 
because they disappear when giving the IfW a 
colour Here the AppWs are the solution as you 
can write text into them. Place as many AppWs 
into a IfW as you originally wanted to place Info 
Objects. Design them without border You want to 
have a blue background and four small texts in 
white ink on it for example? Then write following 
code in the program: 
MWINDOW #3, 1! : WM_PAPER #3, 32799 : CLS #3 FOR 
i%=1 to 4 

SELect on i% 

=Ll:a$="text one" 

=2:a$="text two" 

=3:a$="text three" 

=4:a$="text four" 

END SELect 
MWINDOW #3,1% : WM_PAPER #3, 32799 : WM_INK 
#3,65535 : CLS #3 : PRINT #3,a$ 
END FOR i% 


You want to have a 3D-border around your IfW? 
No problem! 

MWINDOW#3, 1! : WM_PAPER #3, 32799 : WM_BORDER 
#3,2,1026 : CLS #3 

will do the trick (the colour values are explained 
later in this article). And of course the AppWs, too, 
can have a border in the same way, you have only 
to take care that the border-width (in the above 
example=2) leaves enough space for the text. If 
not, you have to enlarge the AppWs. AppWs 
cannot overlap each other and they are checked 
in the MCALL-routine. You have to take care what 
happens to them during the program loop. 


Lis are special because they change their status 
and are therefore redrawn often. Every time, a LI is 
clicked on, you will have to apply the colour anew 
AND to set the status in order to redraw the 
button. See the following code: 

MWINDOW #3,-4 

WM_PAPER #3, 32799 WM_INK #3,65535 
WM_BORDER #3,1,1026: CLS#3: Print #3,"Iama 
button" 

stat%=MSTAT%(#3,-4 to 0) 


This gives the LI number 4 a blue background, 
white ink, a 3D-border of 1px width, the text "lam 
a button’ and makes it appear by setting the 
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status. There are different ways to manage this. If 
you have many Lis, you might prefer to write a 
procedure or function to control this. You may 
even give different appearances to the same 
button, dependant on its status. Write a procedure 
that checks the status of the Lls and gives them 
different colours and/or borders. Adequate com- 
mands are the above mentioned function 
MSTAT% or the procedure MSTAT See the EasyPtr 
manual for further explanation. 

Also, if you have to apply colours very often, you 
could help yourself by defining all colours you will 
use, at the begin of the program 

grey=60250 

pink=64543 

red=64512 


and then write procedures like: 


DEFine PROCedure P (chnr,col) 
WM_PAPER #chnr,col 
END DEFine P 


for PAPER (and for INK and BORDER similar), 
which you can use with P3,pink. It will save you 
a lot of typing. 


There is one bug in EasyPtr which | had never 
noticed in ‘colourless’ times: Never try the 
MWINDOW command on LI number one. It will not 
work! Don't ask me why. 


The only window that cannot have colour is the 
main window. Here, too, the trick is simple. Make 
your very first IW as large as the main window, 
give it a colour and you are there! 


A very special and joyful thing is the use of pic- 
tures as a background or just in a window. 
Wolfgang Lenerz has provided us with an 
extension that will do the job. Together with his 
new program BMP2SPR comes the bmpcvt-ex- 
tension. In this extension there is one command 
which is very interesting for EasyPtr-program- 
mers. It's called WL_bmp8load and loads an 8bit- 
bitmap into a channel. This can be any normal 
SBasic-window and thus an Easymen-window, 
too. The Easyptr-command that will do it, is: 
MWLINK. With this command you link a channel 
into a window. For example: 
1nkechanne1%=FOPEN(con) 

MWLINK #3,1!#1nkchannel% 

WL_BMP8LOAD #1nkchannel%, "win1_my_picture_bmp" 
opens a new free channel, links it to IfW 1 and 
loads "my_picture_bmp’ into it. Simple, isn't it? The 
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only important thing is, that it is really a 256 
colour bitmap. Even the size is not very important, 
if it is too large, it is clipped! 


The newest development "on the market’ are 
programs with which you can create colour 
sprites that have the format you need for 
EasyPtr There are (afaik) two programs to 
produce them, one is the above mentioned 
BMP2SPR by W. Lenerz and another one is a 
small PC-utility, PNGCVT by Marcel Kilgus, which 
transforms PNG-files to QL-sprites. You can use 
them in Easymenu and the good news is: you can 
even see them in Easymenu itself! The bad (but 
not really bad) thing is that you can only take 
sprites of a maximum size of 64x64 pixel in 
Easymenu and when appending them to an 
EasyPtr-appendix file. You may take sprites much 
larger than that, but you will have to store them 
anywhere and load them into your Basic-program 
during runtime. 

There is one new feature in BMP2SPR which 
might turn out to be one of the most beautiful 
things: You can make an ‘extended’ sprite, which 
means that such a sprite can have up to 5 diffe- 
rent appearances dependant on its status. | didn't 
have time to profit from this feature in QCoCo 
because of its being brandnew but | already know 
that it works like any ‘normal’ sprite and that is 
fantastic! You should get your copy of BMP2SPR 
and read the manual for further explanation. 
There are two ways of using a sprite in an Easy- 
Ptr-program. The first one is to add it to a Ll as an 
object as described above. The second one is to 
apply an appended sprite with either the SPRS or 
SPRW-command within the program. For exam- 
ple, with 

SPRS #3,1 

you make the first sprite in your extension file the 
pointer for your program. With 

MWINDOW #3,4!:SPRW #3,0,0,2 

you make the second sprite in your extension file 
appear in IfW 4. As | said in my first EasyPtr 
tutorial, the manual isn't quite clear at this point, 
because ‘name’ or ‘adr’ must actually be the 
number of the sprite in the appendix-file, where it 
is automatically placed after all the menus. 

There was one odd thing | noticed when working 
with this: When you give LIs a sprite (Loose 
ltem—properties—»object in Easymenu) you will 
see them during your Easymenu-session. You 
can save the menu apart or attach it to an appen- 
dix-file and when running a BASIC-program with 
this menu, everything is just fine. However, when 
you load this menu into Easymenu again, the 
sprites are gone and you have to load them 
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anew. | recommend to put them into the menu in 
the very end of menu development. Actually, the 
planning of an Easymenu-menu is more important 
now than it was. You will probably have many 
more windows to hold all your information and in 
order to have good control it is very practical to 
give them different colours in Easymenu. You still 
have lots of stipple colours to manage that. 


Okay, now a few more words about the system 
colours. As you could see, | took the decimal 
values in the commands described above. | want 
to tell you why. A lot has been written about the 
system colours in past QLToday issues. Mostly it 
was information from assembler programmers for 
other assembler programmers. | cannot judge for 
other people but as to me, | was frustrated be- 
cause | didn't understand much of it. When pro- 
gramming QCoCo | had to learn what it's all about 
and with the help of Marcel | succeeded to a 
certain extent. Here's what | can tell those who 
have the same problem | had: 

When it all started we talked about 24bit colours, 
also called ‘true colour’. But in reality the GDI 
driver can handle a 16bit range of colours which is 
‘only’ 65535. So, if you write your SBASIC-pro- 
gram in mode ‘colour_24’ you give HEX-values 
like SFFFFFF (white) for example but the system 
will show you the system colour 65535 (or $FFFF) 
which of course is white, too. In colour_24 mode 
you even HAVE to give Hex-values because the 
decimal values are not interpreted correctly. 

It is therefore much easier to forget about the 
24bit colours at the moment and take only the 
system colours by using the ‘WM_’commands 
(see above) together with a Hex-value or decimal 
value, whatever you prefer The big advantage Is, 
that your program will be ‘understood’ by any 
machine running in 16bit colour mode and if you 
give special windows ‘special’ colours, they will 
even show up in the colours the user of your 
program has defined on his machine. 


How does it work? 
In the whole range of 65535 colours there are 
special ranges for special colours: 


1) From 0 to 255 
(Hex $0 to $FF) are the normal QL-colours 

2) From 256 to 5l11 
(Hex $100 to $iFF) are the palette colours 
(COLOUR_PAL) 

3) From 512 to 767 
(Hex $200 to $2FF) are the systemcolours 
(references) 
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4) From 768 to 1023 
(Hex $300 to $3FF) are grey ‘colours’ 
5) From 1024 to 1279 
(Hex $400 to $4FF) are the 3D-borders 
6) From 16384 to 32767 
(Hex $4000 to $7FFF) are all stipple colours 
7) From 32768 to 65535 
(Hex $8000 to $FFFF) you have the RGB- 
colours 


Nearly all these colours you can use by only 
typing WM_PAPER 17484 or WM_INK $8F8F (Hex 
or decimal is your choice). Two ranges, however, 
are special: range 3) and 5): 

Range 5) are the 3D-borders and its obvious that 
you must not write WM_PAPER or WML_INK, but 
only WM_BORDER with these values. Also there 
are not so many 3D-borders that really work well. 
Marcel had defined some good looking borders 
which were shown in a former issue of QLloday. 
You can also find a picture of them together with 
their values in my program QCoCo. What you can 
try are 3D-borders from 1024 to 1039 ($400 to 
$40F). Other ones may give strange results. The 
most important range for the SBASIC-program- 
mer is range 3). The first 57 of these are 
references to the system palette colours. These 
are the colours that are used in all QPac2-menus, 
QD, FiFi, QSpread etc. They have strange names 
like ‘Application window item unavailable fore- 
ground’ or cryptic ones like ‘Subsidiary informa- 
tion window middleground’. Don't mind, it's much 
less cryptic than it looks. The tool to see what 
they are and do is again QCoCo. Once you have 
understood them you will want to give your pro- 
grams the look and feel of all the system pro- 
grams and that is exactly what these references 
are for: Let's say you want your main window to 
look like the main window of QPac2. The only 
thing you have to do is to give the main window 
of your program the colour 513 ($201). The 
fantastic thing is, in your system this might be a 
light grey, but on the system of another user it is 
just the colour that user has configured it to, 
perhaps red or dark green! You won't have to 
take care whether a user likes your colours: Use 
references for the most important colours of your 
program and it will look different but just fine for 
the user on any system. There is a simple rule to 
find the index of a system palette colour Write a 
small program: 


FOR 1%=512 to 568 
PRINT i% ! (i% MOD 256)+1 END 
FOR i% 
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and you will get a list of the decimal values of the 
system colour palette, together with their index 
numbers 1 to 57. For all those colours you don't 
want to be changed on another system you just 
take the colour values of range 7) (or 1) or 2)). 


From my point of view there are two conclusions: 

~ Programming with EasyPtr is as actual as ever 
before and for those who know it, it remains 
THE tool to write pointer programs and there 
is no need to learn TurboPtr. 

~ referencing to system colours is one of the 
most fascinating achievements the system 
colours have brought us. Together with the 
new colour sprites (and programs to create 
them), the possiblity of using bitmaps (pictures, 


Turbo and Parameters 


George Gwilt 


One complaint about Turbo is that compiled 
programs will not run correctly either if array 
parameters are presented to a machine code 
function or procedure or if such a machine code 
routine alters the values of parameters. 
Q_Liberator allows this, why shouldn't Turbo allow 
it as well? The answer lies in the way Turbo arran- 
ges to call machine code routines. It always pas- 
ses parameters by value even when the parame- 
ter is a variable. A machine code routine finds its 
parameters from the Basic Name Table. The entry 
for each parameter contains a pointer to its value. 
In Basic if the parameter is a simple variable the 
pointer points to the place where the value of the 
parameter is stored. If the parameter is an expres- 
sion, the pointer points instead to the place where 
the value of the expression is stored. In the first 
case it is obviously possible to alter the value of 
the variable. Turbo, on the other hand, always 
treats all parameters as if they were expressions. 
Hence it is not possible to change the value of a 
variable presented as a parameter in a program 
compiled by Turbo. 

For the same reason, a machine code extension 
will fail in a program compiled by Turbo if it is 
presented with an array parameter. 


A Solution 
lf a machine code extension had access to the 
address of a variable’s value in a compiled pro- 
gram it could theoretically alter its value. Equally it 
could access the elements in an array if it knew 
where to look. 
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photos etc.) the QL has been lifted to a higher 
level in the last months. Shouldn't we talk 
about a QCL (QiColourLeap) from now on :-) 
? 


| don't hesitate to say it once more: Thank you 
very much, Marcel, Wolfgang (L.), Phoebus and all 
the others involved in this development! 
BMP2SPR can be downloaded at: 
http://www.scp-pauletlenerz.com/14mljkl24/wolf/download/ 
PBGCVT can be downloaded at: 

http://www. kilgus.net/soft/pngconv.zip 

QCoCo can be downloaded at: 
www.uhlich.nl/ql/qcoco.zip 

lf you have further questions, don't hesitate to 
send me an e-mail: w.uhlig@tiscali.nl 


For its internal operations Turbo replaces Basic’s 
Name Table by a Vector Table. This contains four 
bytes for every name used in a compiled pro- 
gram. For integer or floating point variables this 
long word is a pointer to the value. For arrays, the 
pointer is to a descriptor which in turn will contain 
a pointer to the set of actual values. This is similar 
to the array structure in Basic, but the details are 
different. 


The function TURBO_V, which takes as its only 
parameter the name of a variable, returns the 
absolute address in the Vector Table of the four 
byte entry for that variable. 


Thus, in a program to be compiled by Turbo, we 
might put 

1000 EXT TURBO_V(count%) 

if EXT is a procedure expecting to alter its 
parameter. 


The procedure itself would, of course, have to 
take appropriate action depending on whether it 
is Operating in a program compiled by Turbo or 
not. Assuming such a test can be made, EXT 
would have to arrange to read in the long word 
parameter TURBO_V(count%) if compiled, but the 
integer parameter otherwise. 


In the compiled case, the value of the integer 
comes from the address in the Vector Table. The 
changed parameter is then simply fed back to the 
same address. This is in fact an easier process 
than asking the operating system to return the 
parameter. 


The same process applies to floating point 
parameters. 


Ss 


For strings, there is a slight complication. It will not 
be possible for EXT to alter the size of space 
used by Turbo to hold the string parameter. This 
means that a returned string parameter is con- 
Strained to be no more than the dimensioned size 
of the string. 


Accessing arrays in Turbo is very similar to ac- 
cessing arrays in Basic. Of course, in Basic, the 
pointer to the descriptor will come from the 
parameter information in the Name Table. In a 
compiled program the pointer is the long word 
parameter pointing to Turbo's Vector Table. 


Finding whether a program is compiled by Turbo 
can be done by examining the long word at the 
34th byte from the start of the program. If this is 
not “Turb’ it is not compiled by Turbo. 


To show how all this works, an actual example Is 
given. The extension keyword is EXT1 which can 
be loaded by LRESPRing file EXT1_BIN produced 
by assembling EXT1_asm. 


The procedure EXT1 takes three parameters. The 
first is a simple integer variable, the second a 
simple string and the third a one dimensional 
integer array. EXT1 takes the first parameter as an 
index into the array (the third parameter), extracts 
the value and sets it into the first parameter EXT1 
also strips off a trailing "_asm’ found in the string 
parameter. 


The listing of EXT1_asm is given later. As it stands 
it can be assembled by either GWASL or GWASS. 
An example of a Basic program using it might be: 


1 TURBO_objfil ‘ram1_test_ext' 

2 TURBO_taskn 'test_ext' 

3 TURBO_objdat 2 

4 TURBO_repfil 'raml_err':TURBO_buffersz 2 

5 TURBO_diags 'i':TURBO_struct 1:TURBO_model 

1 

6 TURBO_optim O:TURBO_windo 0:TURBO_locstr 0 

y ae 

100 a%=3 

110 DIM v%(6) ,a$(40) 

120 v%(3)=-791: a$="flpi_test_asm" 

130 Pr:REMark print before 

140 IF COMPILED:EXT1 TURBO_V(a%), TURBO_V(a$), 
TURBO_V(v%):ELSE :EXT1 a%,a$,v% 

150 Pr 

160 CLOSE#3:STOP 


180 DEFine PROCedure Pr 
190 IF a%=3:Wind 

200 PRINT#3,a%,a$ 

205 SUSPEND_TASK 200 
210 END DEFine 


230 DEFine PROCedure Wind 

240 OPEN#3,scr_200x40a10x10 

250 PAPER#3,'7: INK#3,0:BORDER#3,2,2,4,3:CLS#3 
260 END DEFine 


Lines 1 to 6 tell Turbo how to compile the 
program, but are ignord by S*BASIC. 

Line 140 shows the two ways of calling EXT1, 
depending on whether the program is compiled 
or not. 


3; EXTi_asm 

3 To show how Turbo can deal with 
; (a) Altered parameters 
(b) Array parameters 


This sample procedure EXT1 a%,a$,v% 


Nee Wee Wee Wee ee we 


sets a%=v%(a%) where v% is a one dimension integer array 
and strips off a trailing _asm (regardless of case) from a$ 


BV_VVBAS EQU $28 

BV_RIP EQU $58 

START LEA DEFINE, A1 

MOVE.W BP_INIT,A2 

JMP (A2) 

DEFINE DC.W 1 one proc 

DC.W EXT1-—* 

DC.B 4, "EXT1" 

DC.W 0 end of procedures 

DC.W 0 no of functions 

DC.W 0 end of functions 

EXT1 LEA 24(A3) ,AO 

CMPA.L AQ, A5 

BNE BAD_PAR > 3 parameters needed 
BSR TURBT are we in a Turbo program? . . 
BNE NON_T - no — act normally 
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Think your own thoughts. 
Q60. The Super QL. 


Features 

Q60/60 & Q60/66: 68060 CPU, 60/66 MHz, MMU+FPU 
Q60/80: 68LC0O60 CPU, 80 MHz, MMU (no FPU) 

68060 superscalar architecture, dual execution units 

Up to 160 BogoMIPS performance for Q(DOS+SMSQ/E 
16 to 128 MB RAM, PS/2 module sockets 

256 kB ROM (mainboard supports up to 1024 kB) 
Highspeed 32 bit graphics + original QL hardware modes 
Up to 65536 colours at 1024 x 512 pixel resolution 
Multisync monitor output (15 pin HD connector) 

PC Keyboard interface (DIN) 

20 kHz Stereo sound 

Battery buffered clock, 2 KB nonvolatile RAM 

Controller for 2 floppies and 2 IDE harddisks or CDROM 


2 Serial ports with 115200 Baud, Parallel port (on I/O 
card supplied with mainboard) 


Hardware extension slot supports ISA cards 

Fits directly into AT Minitower or other standard case 
+5V / +12V power supply 

No tinkering, no parts from original QL needed 
Mainboard size 8.2 x 6.3 inch 

Can boot in a few seconds, directly from ROM 


Runs three different operating systems: 
SMSQ/E, QDOS Classic and Q60 Linux 


New ,ShoeString* Q60 Linux distribution 


x 
x 
x 
x 
x 
x 
x 
x 
x 
x 
x 
x 
x 
x 


Prices 

Complete Systems 

Q60/60 Midi Tower* 

68060 @ 60 MHz, MMU+FPU, 
64MB RAM, CD-ROM 56x, 
3.5" Floppy, 20 GB Harddisk, 
Keyboard, 3 Button Mouse, 
2 SER, 1 PAR, Stereo Sound £ 545.00 | 


Higher mainboard spec. 

Q60/66 (68060, 66 MHz) + £ 139.00 
Extras 

RAM 
16 MB (giving 80 MB) £17.00) 
64 MB (giving 128 MB) £ 36.00 | 
I/O Card (FLP,IDE,SER,PAR) £14.00 | 
Floppy disk drive £11.00 
Operating System 
OS programmed on ROMs** = £10.00 | 
Q60 Linux CD £15.00 | 
Ethernet Card 10 Mbit/s £17.00 
Stereo speakers 

3 boxes, including sub-woofer £19.00 | 
Preinstalled software package 
QPAC1, QPAC2, FiFi, QD, 
PROWESS and much more, EF 
over £100 worth £ 59.00 | 


* Fully assembled and tested! Includes support disks and manuals. 
** SMSQ/E and QDOS Classic available 
Shipping and handling is extra. Prices may change due to semiconductor costs or exchange rates. Please 
note: Current SMSQ/E version supports only 16 MB out of 64 MB RAM, or 32 MB out of 80/128 MB RAM. 
Linux fully supports all memory configurations. 


Website and technical information: 


www.q40.de 
Email: info@q40.de 


D&D Systems 


P.O. Box 5813, Ripley, Derbyshire, England DE5 9ZR 
Tel. +44 (0)1773-740170, FAX +44 (0)1773-748399 
After sales Tel. +44(0)1773-741 164 (evenings) 


Email: sales@q40.de 
Financially assisted by a loan from QUANTA 


Take the power back in your hands. 
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3 
3 
3; parameters 

3 

MOVEA.W CA_GTLIN,A2 


JSR (A2) 
BNE BAD_PAR 


emcamamraa J 


Here we expect pointers to Turbo's Vector Table in place of the 


2 
3 Now pointers to the Vector Table are on the Maths Stack 


3’ 

MOVEA.L (A1,A6.L),A2 
MOVEA.L  (A2),A2 

MOVE.W  (A2),D2 
MOVEA.L  8(A1,A6.L),A0 
MOVEA.L (AO), A0 

TST.W 8(A0) 

BNE BAD_PAR : 
CMP.W 10(A0) ,D2 

BGT O_RANGE ; 
MOVEA.L  (A0),A0 

ADD.W D2,D2 

MOVE.W (AO, D2.W), (A2) 


3 


3; Now the string 


2 

MOVEA.L 4(A1,A6.L),A0 
MOVEA.L (A0),A0 

CMPI.W #-1,8(A0) 

BNE BAD_PAR ——> 
MOVEA.L (A0),A1 

SUBA.L AG6,AL 

BSR STR 

END MOVEQ #0,D0 
RTS 


pointer to the value of a% 
a% is now in D2.W 
Vector Table entry for v% 
pointer to the descriptor 
One dimension? . . 
- . no 
In range? .. 

- no 
pointer to values 


set the value in a% 


pointer to the descriptor 
no dimensions? . . 
- no — not a simple string 
pointer to string 
pretend to be in Basic 
deal with the string 


3; Here is the "normal" processing 


NON_T MOVEA. W 
LEA 8(A3) ,A5 

JSR (A2) 

BNE BAD_PAR ——> 
MOVE.W (A1,A6.L) ,D2 
MOVE.W 16(A3,A6.L) ,DO 
ANDI.W #$FFOF,DO 
CMPI.W  #$303,D0 

BNE BAD_PAR , 
MOVEA.L  20(A3,A6.L),A2 
MOVE.L  BV_VVBAS(A6) ,DO 
ADDA.L DO, A2 

CMPI.W = #1,4(A2, A6.L) 
BNE BAD_PAR > 
CMP.W 6(A2,A6.L) ,D2 
BGT O_RANGE ; 
MOVEA.L  (A2,A6.L),A2 
ADDA.L DO, A2 

ADD.W D2,D2 

ADDA.W D2, A2 

MOVE.W 

MOVE.L  A1,BV_RIP(A6) 
MOVEA.W  BP_LET, A2 

JSR (a2) 

BNE BAD_PAR ——>» 


3 Now the string 


MOVEA.L A5,A3 

LEA 8(A5),A5 

MOVEA.W CA _GTSTR,A2 

JSR (A2) 

BNE BAD_PAR > 
14 


CA_GTINT, A2 


for 1 parameter 


a% to D2.W 
Name Table entry for v% 


an integer array? .. 

- . no 

pointer to descriptor rel to VV_BAS 
relative start of VV_BAS 
—» descriptor rel to A6 
one dimension? . . 

- » no 

In range? .. 

- . no 

—» itmes rel to VV_BAS 
—>» items rel to A6 


—» v%(a%) rel to A6 


(A2,A6.L),(A1,46.L) set a% 
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BSR STR 

BNE END no change in string 
MOVE. L A1,BV_RIP(A6) 

MOVEA.W  BP_LET,A2 

JSR (A2) 

BRA END 

BAD_PAR MOVEQ #-15,DO 

RTS 

OLRANGE MOVEQ #-4,D0 

RTS 


3; Subroutines 


3 
3; TURBT sets CC Z if compiled by Turbo 
3; Uses no registers 


Ps 

TURBT MOVEM.L A0—-1/D0-2,-(A7) 

MOVEQ #-1,D1 This Job 

MOVEQ #0,D2 Top Job 

MOVEQ #MT_JINF,DO 

TRAP #1 

CMPI.L #"Turb" , 34(A0) EQ if compiled by Turbo 
MOVEM.L (A7)+,A0-1/D0-2 


’ 
3; STR does the work needed to see if the string needs shortening. 
3 (A1,A6.L) points to the string. 


2 

STR MOVE.W (A1,A6.L) ,DO length 

SUBQ.W #4,D0 set reduced length 

BMI STEND too short — can't be _asm 
LEA 2(A1,D0.W) ,A2 point to last 4 characters 
MOVEQ #3,D5 count - 1 

ST1 ROL.L #8 ,D3 move up a byte 
MOVE.B (A2,A6.L) ,D3 put in the next byte 
ADDQ.L #1,A2 step to the next character 
DBF D5,ST1 count to four characters 
ANDI.L #$FFDFDFDF , D3 set 'asm' to upper case 
CMPI.L #'_ASM' ,D3 Was it "_ASM"? .. 

BNE STEND - . no 

MOVE.W DO, (A1,A6.L) set the reduced length 
MOVEQ #0,D0 mark a change occurred 
STEND RTS 


An Alternative Partial Solution 


The obvious problem with the method described 
above is that it won't work unless the extensions 
are re-written. This may be possible in some 
cases but not in others. A different approach was 
suggested by Wolfgang Lenerz. That is to alter 
the code for BP_LET so that it took account of 
whether the program it was in was compiled by 
Turbo or not. If it was, BP_LLET would find the 
address of the appropriate entry in the Vector 
Table and so determine the address of the 
variable. It seems logically possible for Turbo to 
pass the required Vector Table address to 
BP_LET so a future version of Turbo might do 
this. 


The advantage of this method is that no change 
would be required in the extension keywords 
involved, nor in the S*BASIC programs them- 
selves. It would mean, however, that these pro- 
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grams would have to be recompiled with a new 
version of Turbo. Also, the resulting programs 
would only run on appropriate future versions of 
SMSQ/E. 

Finally, this method does not solve the problem of 
array parameters. 


Summary 

Two methods have been described which would 
enable Turbo to compile programs containing 
calls to machine code routines which alter their 
parameters. The first method also allows array 
parameters. 

The first method can be applied now to any new 
or revised extension keywords and to any new 
or revised S*BASIC program. 

The second method would not cope with array 
parameters and has not been implemented at the 
moment. 
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Programming QPTR in 
BASIC - third part 


Wolfgang Lenerz 


Reading th Pointer 

Reading the pointer will enable you to get the 
user's response to the different possible menu 
actions. This, of course is a paramount part of 
programming in the Pointer Environment. You 
have the choice between two different methods 
of reading the pointer with three different 
keywords (two of which are very similar). The 
first method is the most interesting, even though 
the second, a directy pointer read, can also be 
useful. 


| - Reading the pointer indirectly 

This method makes our programming much 
easier It is structured around the RD_PTR (ReaD 
PoinTeR) and the RD_PTRT (ReaD PoinTeR 
with Timeout) keywords. When one of these 
commands is used, the pointer is drawn on the 
screen (in the shape determined by the working 
definition). The user can move the pointer via the 
mouse or the keyboard cursor keys. The com- 
mands will only come back to the program when: 

1) The user did (and in some cases hit) an item 
in a menu or an application subwindow (or 
used the respective selection key) and 

2) this action did happen in this window - 
nothing will happen if the user clicked out- 
side of the window. 

3) With the RD_PTRT keyword, a return can 
also be made when a timeout or "job event’ 
OCCUTS. 

The advantage of this command seems obvious: 
it handles all of the changes in the pointer shape 
and state, notably if you have specified different 
pointers for application subwindows: the pointer 
will automatically change when it is brought over 
such an application subwindow. Likewise, when 
the pointer is moved outside of the primary win- 
dow, it may change shape and become that of 
another window, or the default sprite (an arrow) 
or a sprite showing that the window underneath 
is not a managed window or expects keyboard 
input etc. 

A click outside of the window is not acted upon, 
and, in fact the command only comes back in 
case of a timeout or job event (for RD_PTRT) 
and when the user somehow actioned some- 
thing inside of the window. 
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That's very practical for the programmer When 
the command returns to the program, return 
parameters indicate what happended. Thus, there 
are a LOT of parameters for this command, but 
they are all pretty logical. We'll start with the 
RD_PTR command: 


1-RD_PTR 


RD_PTR workdef, item%, subwin%, eventZ, 
xrel%, yrel%, liflags% {[,appflags% 
[,ctrldefx% ,ctrldefy%]]} 


Quite a mouthful 


The parameters are the same for both RD_PTRT 
and RD_PTR, and they are as follows: 


- * workdef is the window working definition. 
The window can be a secondary or a pri- 
mary window, according to how workdef is 
set up. Unfortunately, when there is a pri- 
mary window and a second window it is 
not possible to choose in which one of 
these you want to read the pointer: indeed, 
if you open a secondary window ‘over’ a 
primary one (eg. the "commands menu in 
the QPAC 2 FILES program) the secondary 
window locks the primary window over 
which it is pulled down and which it covers 
totally or partially. The primary window thus 
no longer is the window on top and can't 
read the pointer anymore. 


» * item% is a returns parameter. It contains the 
number of the item the user hit or did, and 
which caused the command to return. The 
return mechanism is as follows: you may 
remember that one of the parameters for a 
the definition of a loose menu item or a 
menu application sub-window is its type 
(text, sprite etc) to which one adds 256 or 
-256: this type will then determine how the 
item reacts when hit/done: 

- If nothing is added to the item type , then 
this item acts as follows when actioned: if 
the item is hit, it just changes state - if 
selected it becomes available and if avai- 
lable it becomes selected, but it DOES 
NOT cause the RD_PTR command to 
return. If the item is done, it changes state 
(to show that it was selected and hit) and 
then causes the command to return. 

- If -256 is added to the items type, both 
actions (hit or do) will produced the same 
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result, ie. a change of state towards 
selected (or available if the item was 
already selected) and a return form the 
RP_PTR command loop. 

- If 256 is added to the item type , both a 
hit and a do will again, have the same 
result: the item will cause the RD_PTR(T) 
command to return to basic, but the item 
State will automatically be reset to availa- 
ble, without any programmer intervention. 

These last two cases (256 and -256) thus 

cause an ‘automatic return’ from the item 

when it was hit or done. 


subwin% is also a return parameter. It con- 
tains the number of the (application) sub- 
window in which the pointer was located at 
the time of the user action. If the pointer 
was not in an application subwindow but 
on a loose menu item or anywhere else in 
the window {an information sub-window, for 
example) then this parameter will be -1. 
With this, you can determine and find out 
whether the user clicked a loose menu 
item or an item in an application sub-win- 
dow. 


event%, again a return parameter, contains 

the ‘event’ that caused this return. This 

“event” may be either the fact of actioning 

an item/object, or the press of any of the 

following keys: ESC, Fi, CTRL Fi, CTRL F2, 

CTRL F3 or CTRL F4. To each of these 

keypresses corresponds a certain event, 

and each event has a code which is thus 

returned in the event% return parameter 

These codes are: 

1 = DO: an item was done (ENTER) 

2 = CANCEL: ESC was pressed 

4= HELP : Fi was pressed 

8 = MOVE : CTRL F4 was pressed (move 
window) 

16= SIZE : CTRL F3 was pressed (change 
window size) 

32= SLEEP : CTRL Fi was pressed (make 
into button) 

64= WAKE : 
(WAKE) 

128= HIT on an item with an automatic 
return. 

Thus, the above keystokes will also cause 

a return from the RD_PTR(T) pointer read 

loop. 


CTRL F2 was pressed 
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>» * xrel% and yrel% are the pointer coordi- 
nates at the time when the event caused 
the return to the program. These coordi- 
nates are relative to the upper left corner 
of the window (of the application sub- 
window} in which the pointer was when 
the return occurred. 


» * liflags% is the same flag array for loose 
items as that used for the DR.PULD and 
DR_PPOS keywords (see in an earlier in- 
Stalment of this series). Remember these 
flags may have a value of 0, 16 and 128. If 
you add one to these values when calling 
the RD_PTR command, then the item will 
automatically be redrawn in the appropriate 
Status. 


» * appflags% is the same flag array for 
application subwindows that is used in the 
DR .PULD and DR_PPOS commands 
which we treated in an earlier instalment of 
this series. Just like for loose menu itmes, 
if you set any value of these flags arrays 
to the status +1, the items will be redrawn 
automatically upon entering this command. 


» * ctrldefx% and ctridefy% are the application 
sub-window control definition arrays. 


Using this command is pretty easy because it 
only causes a return for well defined events. It 
can get included in a pointer read loop which will 
be about as follows: 
REPeat loop 
RD_PTR « parameters» 
post=item%:REMark SELect on floats only in QDOS 
SELect ON subwin 
=-1 : rem loose menu item 
SELect ON post 
=1:do_this 
=2:do_that 
=3:something else 
- etc... 
END SELECT 
=0 : rem click in first menu appsub wdw 
SELect ON post 
END SELect 
END SELect 
END REPEAT loop 


Thus, one reads the pointer and when the return 
was made, one uses the subwindow and the 
item to determine, first, in what subwindow the 
event occurred and, second, what action should 
be taken for this event. 
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2-RD_PTRT, timeouts and job events 


The RD_PTRT keyword is pretty similar to the 
RD_PTR keyword. Both use mostly the same 
parameters, except that the RD_PTRT keyword 
has one additinal parameter, a timeout, as follows: 


RD_PTRT workdef, item%, subwin%, event, 
timeout%, xrel%, yrel%, liflags% 
{[,appflags% [,ctrldefx% ,ctrldefy%]]} 


The wordkdef, item%, xrel%, yrel%, liflags%, 
appflags%, ctridefx% and ctridefy% parameters 
are the same as for RD_PTR and thus don't 
need to be described here anymore. 


There are two changes with respect to the 
RD_PTR keyword: 


First of all, there is an additional timeout% para- 
meter With this you can indicate that you also 
want a return from the keyword after a certain 
time. In usual QL fashion, the timeout is given in 
1/50th of a second (me thinks, in North America 
it is in 1/60th of a second). 


Thus, you can also make sure that you return 
from the read pointer loop after a certain period 
of inactivity. Mind, though, that the return will be 
made either because of a normal’ event (includ- 
ing "job events, which I'll explain below) or be- 
cause of a timeout - whatever comes first! 


When a return from a timeout occurs, the event 
parameter is set to -1, which is a value it doen't 
normally have. This allows you to distinguish 
between normal events and a timeout. 


Speaking of the event% parameter, this has been 
modified a bit. It still has all of the functions as for 
the RD_PTR keyword, but has been extended. 
You can also use it as an entry paramter for the 
RD_PTRT command, to pass it some ‘job 
events’ on which the keyword will also return. 


Job events are a relatively recent addition to the 
Pointer Environment. They are an easy, legal and 
(now) documented way for one job (program) to 
communicate with another One program can 
send another an “event”. The other program re- 
ceives the event through the read pointer loop. 
There are 8 events, contained in one byte, each 
bit representing one event. 


Sending an event is pretty easy, and uses the 
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typical TK Il fashion of determining a job: 


SEND_EVENT job_id, event 

(the job_id is a composite number: job_tag * 
65536 + job_nbr), 

or 


SEND_EVENT "job_name", event 
or 
SEND_EVENT jb_nbr, job_tag, event 


For example: 

SEND_EVENT "Quill",3 

will send events 1 and 2 to Quill. This wouldn't 
mean a lot, since Quill isn't equipped to receive 
events, but it could be done. 


When the program is a pointer program, it will 
receive the event throught the pointer read loop. 
In S*Basic, this event may cause a return from 
the pointer read loop: "May" not ‘will’ - at least not 
necessarily. 


Indeed, the event% parameter will indicate, on 
entry to the command, what job events the 
program is ready to receive. If the event% 
parameter is 0, it is not ready to receive any 
event. If event% = 1 * 256, it is ready to receive 
event 1, if it is 3 * 256, the program is ready to 
receive events 1 & 2 and so on. 


As you can see, the event is passed in the high 
byte of the event% word, thus just multiply the 
events to indicate by 256. There is one problem: 
if you want to indicate that you are ready to 
receive all 8 events, you would normally have to 
pass 255*256. This will cause an error so use -1 
instead. 


On return from the read pointer loop, the job 
events are contained in the upper byte of the 
event% word. 


There is also a way to get an event without 
reading the pointer: 
result%=WAIT_EVENT (events% [,timeout%]) 


This will wait for timour% ticks (if this parameter is 
not passed, it waits forever) until on of the 
evnts% passed on entry happens. The event(s) 
are returned in result% 


This was the easy way to read the pointer Next 
time, we'll look at a more circumvallated way of 
doing this. 


QL Forever! 
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Im stillen Winkel 12 D-47469 Duisburg 
Tel. 0203 502011 Fax 0203 502012 
http://smsq.j-m-s.com smsq@j m s.com 


Sooo much colour... 


... talk in this issue - can you imagine not having it? 


As mentioned in earlier issues, please send in your master disks for proof 
of purchase. They will be returned unmodified to you, so that you still have 
access to the older versions. For every product listed below, you will get a 
new disk with the current high-colour updated software! 
| suggest you order the Colour Utility disk one time if you upgrade to 
high-colour, as it contains utilities and samples how to change colours, 
themes and even sprites within a theme (thanks to Roy Wood and Marcel 
Kilgus). 


ee e 
QPC2 Version 3 - Upgrade from QPC2 Version 2 EUR 20,40 
QPC2 Version 3 - Upgrade from QPC2 Version 1 EUR 44,90 
QPC2 Version 3 - Upgrade from QPC1 EUR 69,90 
SMSQ/E Version 3 - Upgrade for (Super)GoldCard with Aurora-Colour Drivers EUR 34,90 
QPC2 Version 3 - Update from QPC2 Version 3 to current Version EUR 0,80 
SMSQ/E Version 3 - Update from ATARI, (Super)GoldCard or QXL EUR 0,80 
text87patch (see description under "News") EUR 12,00 
We recommend the Colour Utility Disk if you upgrade to SMSO/E Version 3! EUR 0,80 
QD2003 - Upgrade from QD98 [VB.01] EUR 14,90 
QD2003 - Upgrade from previous versions [VB.01] EUR 29,90 
QSpread2003 - Upgrade from QSpread2001 [V4.00] EUR 14,90 
QSpread2003 - Upgrade from V1 [V4.00] EUR 39,90 
FiFi li - Update from V4.xx [V4.30] EUR 0,80 
FiFi Il - Upgrade from Fifi V1, 2 or 3 [V4.30] EUR 9,90 
WINED - Update [V1.26] EUR 0,80 
EPROM Manager - Update [V3.02] EUR 0,80 
QPAC I - (Important! New Sysmon for SMSQ/E V3) [V1.09] EUR 0,80 
QPAC Ii - Update with some useful improvements [V1.42] EUR 0,80 
QSUP - Update [V4.00] EUR 0,80 
QMAKE - Update [V4.3 1] EUR 0,80 


Prices include NEW DISK PER PRODUCT AND POSTAGE PER DISK for deliveries to 
Europe. For delivery to USA, add EUR 0,20 per disk. 
Please add one-time packaging charge 2 EUR for Europe, 4 EUR for USA. 
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QLTdis part 11 


Norman Dunbar 


Well, my enforced period of redundancy is over 
(for now) as |am once more working as an Oracle 
DBA. This time I'm on a 3 month contract (finishing 
in March 2004) at a certain large bank in Knuts- 
ford, Cheshire. This means that I'm typing this in 
my ‘digs’ in a small village B&B on my laptop. | 
think | started this whole series on a laptop in 
Manchester at Oracle training, and here | am, 
doing a similar thing five or six years on. Can it 
really be that long ? (It seems longer!) 


Well, it looks like the register list decoding routine 
required by the MOVEM instructions have got me 
beaten. The code | converted from SuperBasic 
doesn't actually work (properly). 


To this end, and after much wailing and gnashing 
of teeth, I've had to admit defeat on decoding the 
register lists using code to check the various bits. 
It is unfortunate, but as soon as | tracked down 
one problem, other bit’s (no pun intended) I'd 
already fixed stopped working again. The comes 
a time when enough is enough. 


I've redesigned the register list decoder to use a 
pair of tables. The first holds an offset into the 
second table as a word of data. The second table 
holds all the instructions decoded according to 
the bit value in a byte The full code is shown 
below, but here is a small extract of what I'm on 
about. 


reg off equ * 

rl de.w mml_l—reg_table 
r2 dce.w mml_2-reg_table 
r_3 dce.w mml_3-reg_table 


That is the first offset table. It simply holds one 
word in each element. The word is the offset into 
the reg_table where the decoded register list 
string can be found for the specific value of the 
byte holding the register list ‘bitmap. The 
reg_table looks like this: 


reg table equ * 

mml_1 de.w mml_2-—mml1_1-—2 
de.b 'DO! 

mml_2 de.w mml_3-mml_2-2 
de.b 'Di' 

mm1_3 de.w mml_4-mm]_3-2 
de.b 'DO-D1i' 
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And so on and on for 256 entries in each table. 
Now, I'm not fond of typing all this stuff in line after 
line, so here's a small program to build up the first 
table followed by the second table as much as 
possible. 


1000 REMark Alter the file name in the 
following line to suit where you keep 

1005 REMark your source files. 

1010 : 

1015 OPEN #3, 'winl_source_dis_reglist_asm' 

1020 : 

1025 REMark Build reg_off table first 

1030 PRINT #3,'reg off equ ¥*! 

1035 FOR Label = 1 TO 255 

1040 PRINT #3, 'r_'; Label; ' 
Label; '-reg_table' 

1045 END FOR Label 

1050 PRINT #3 

1055 : 

1060 REMark Then build reg_table table (!) 

1065 PRINT #3,'reg_table equ ¥T 

1070 FOR Label = 1 TO 255 

1075 PRINT #3, 'mml_'; Label; ' 
mml_'; Label+1; '-mml1_'; Label; 

1080 PRINT #3, ' de.b'; " "Di 

1085 END FOR Label 

1090 PRINT #3, 'mm1_256 equ *! 

1095 : 

1100 REMark All done 

1105 PRINT #3 

1110 CLOSE #3 


de.w mml_'; 


de.w 
tor 


That should reduce the typing somewhat. All you 
have to do now is load the file into your favourite 
text editor and fill in the register lists as per the full 
listing below. I'm a big fan of getting the QL to do 
the hard work for me as much as | can. 


Actually, if you wanted to, and didn't mind the 
format, you could write a function which takes a 
byte value parameter and returns a string holding 
the decoded register list. Sounds complicated but 
it isn't. 


The returned string could look like 'D1,D2,D3,D7 
instead of 'D1-D3,D7’". If you did that, you wouldn't 
need to type anything in for the reglist_asm file. 
Actually, it could be worse, the decoded instruc- 
tion could be shown as: 


movem.1 (a7)+,d0,d1,d2,d3,d4,a5,d6,d7/ 
a0,al,a2,a3,a4,a5,a6 


rather than the much more user friendly: 
movem.1 (a7)+,d0-—d7/a0—a6 


However, think of all that typing you won't have to 
do :o) 
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Try this function for size: 


2000 DEFine FuNction RegList$(bitmap) 


2005 LOCal RList$, bit 

2010 RList$ = '' : REMark no space between 
quotes. 

2015 FOR bit = 0 to 7 

2020 IF bitmap && 2°bit THEN 

2025 RList$ = RList$ & ',D' & bit 

2030 END IF 

2035 END FOR bit 

2040 RETurn RList(2 TO) : REMark strip off 


the leading comma 
2045 END DEFine RegList$ 


With this in place, change line 1080 to the follow- 
ing: 


1080 PRINT #3,,'de.b',"'"&RegList$(label)&"'" 


In case the quotes are funny in the printed 
magazine, they are double single double, at the 
start and end of the call to RegList$(label). Ok 
enough of this, onwards with the code descrip- 
tion. 


We need to use two tables because of the pro- 
blem that the decoded register lists are variable 
length strings. In reverse order, the second table 
holds a list of 255 register list strings in normal 
QDOSMSQ format with a word count followed by 
the bytes of the string. 


The first table, reg_off, is simply a table of 255 
words. Each word is the offset from the start of 


ea 
* TYPE 27 - the MOVEM instructions 


Po cere a a 


the second table to the start of the decoded 
string for the appropriate bitmap. 


We will of course require a table of data register 
lists and one of address register lists, won't we? 
So why does the code above only build a single 
table of data register strings? 


You may well be thinking ahead and saying to 
yourself, ‘does this mean | have to type in another 
table for the Address registers?’. Thankfully, the 
answer is ‘no’. The same table will be used, but 
when we are decoding a data register list, the 
decoded string is appended to the output buffer 
as Is. 


lf, on the other hand we are decoding a list of 
address registers, then we will replace all the ' D’ 
characters with an ’A’ at some point before or 
after it gets appended to the buffer. 


What we will do is copy the register list string into 
the input buffer (which we are not using at this 
point in time) then replace the every 'D' with an 
A’. 

Once we have done this, the resulting string is 
copied from the input buffer to 

the output buffer. 


The following code replaces everything in the 
original type 27 routines. 


Check the size specifier 
Clear = .W 

Add '.L' size details 
Set the op-code size too 
Skip word stuff 


3 Add '.W' size details 
3 Set the op-code size 


dtype_27 btst #6, 47 7 
beq.s t27_word ; 
bsr ell H 
moveq #4,45 3 
bra.s t27_all ; 

t27_word bsr uu 
moveq #2,05 

t27_all bsr space 3 
move.w (a6)+,-—(a7) 7 
btst #10,da7 ; 
beq.s t27_r2m ; 

t27_m2r bsr eff_addr : 
bsr comma 3 
move.w (a7)+,d2 5 
ror.w #8,d2 F 
move.b d2,d4 F 

t27_addr bsr addr_reg 7 
bne.s t27_mask ; 
lea buffer,ai H 
bsr.s t27_append ; 

t27_mask ror.W #8,d2 : 
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Add a space to the buffer 
Stack the register list word 
Set = Mem—>Reg 

Clear = Reg-—>Mem 


Effective address is extracted 
Then a comma 

Get the register list word 
Rotate the high byte —> low byte 
Copy the (old) high byte 


Extract the address registers 

No address registers to copy, so don't ! 
Decoded address register list is here 
Append to decoded instruction 


(old) low byte back again 
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% D2.B holds the data register mask now. D4.B still holds the address register 
* mask. T27_SLASH will determine whether a slash is required in the fully 


% decoded 


t27_data 


+27_skip 


* At this 
* have to 


register list. 
bsr t27_slash 3; Add a slash if required 
move.b d2,d4 3; Get the data register list 
bsr data_reg 3 Extract them 
bne.s t27_skip 3; Nothing to copy, so don't ! 
movea.1 a3,al ; Data register list string 
bsr.s t27_append 3; Add to output buffer 
bra p_hex 3; Finished with mem —- reg 


point we are processing a register to 
do some extra processing to determine 


* used and if so, reverse the order of the bits 


memory MOVEM instruction. We 
if pre-decrement mode is being 
in the register bitmap. Why 


* Motorola chose to have one single instruction with the bits back to front, I 
* don't know ! 
t27_r2m move.w (a7)+,d2 3; Fetch the register list word 
andi.b #$38,d0 ; Extract the mode bits in the op-—code 
empi.b #$20,d0 3 Mode = '100' = pre-decrement 
bne.s t27_notpd 3; Not pre—decrement 
bsr swap_d2 3 Reverse the bits in D2 for pre—dec 
+27_notpd move.b d2, a4 ; Data registers in low byte 
bsr data_reg 3 Extract them 
bne.s t2'7_nodata 3; No data registers to copy, so don't ! 
movea.1 a3,al 3; String location 
bsr.s t27_append ; Append data reg list to output buffer 
t27_nodata ror.wW #8,d2 3 Shift address register mask to low byte 


* D2.B holds the address register mask now. D4.B still holds the data register 
* mask. T27_SLASH will determine whether a slash is required in the fully 


* decoded 


t27_comma 


* 


register list. 
bsr t27_slash 3; Add a slash if required 
move.b d2,d4 ; Address register list bitmap 
bsr addr_reg 3; Extract address register list 
bne.s t27_comma 3; No address registers to copy. 
movea.1 a3,al 3 String location (from address) 
bsr.s t27_append ; And append the address register list 
bsr comma 3; Comma required 
bsr eff_addr 3 And finally, the effective address 
bra p_hex 3; Finished with reg —> mem 


® T2'7_SLASH — adds a slash if required 


% 
* D4.B 
* D2.B 
x 

* A slash 
x 
t27_slash 


t2'7_nos12 


& 


address (or data) register list mask 
data (or address) register list mask 


will be required if both are non-zero. 
tst.b d2 3; No slash if zero 
beq.s t27_nosl2 
tst.b a4 ; No slash if zero 
beq.s t27_nos12 
bsr slash 3 Adda '/! 
rts 


* T2'7_APPEND — append the decoded register list to the decoded instruction 


* buffer. 
¥ 


* D6.W holds the current size of the output buffer and A5.L is the pointer 
* to the first free character in said buffer. This means that the str_append 
* sub-routine is not useful here until we do some jiggery—pokery with the buffer. 


22 


QL loday 


New Websites! 


We are proud to present our new websites! 
Starting September, we have separated our business in three 
separate websites. 


You can find them at: 


<http://www.rwapadventures.com/> (Adventure Games) 


<http://Awww.rwapservices.co.uk/> (General Site) and 
<Http:/www.rwapsoftware.co.uk/> (Software) 


Our old address: <http://hometown.aol.co.uk/RWAPSoftware/> 
is of course still functioning but will be deprecated in the future. 


SOUND ON @RE2I 


The wait is now over! Q-Word version 1 is finally available! 


Platforms: 
QPC/QXL, Q40/Q60, Aurora (with SGC) 


Prices: 


All versions without P-Word £20.00p 
All versions with P-Word £30.00p 


Notes: 

Q-Word DOES NOT require SMSQ/E with GD2 support -OR- SMSQE atall on 
the Aurora or Qx0 machines. It works on the highest colour depth everywhere 
regardless of Operating System. 

The Aurora version is available on either HD or ED disk. For the latter add 
£1.00 to the price. ED version is uncompressed and can be run directly from 
the floppy. All other Floppy versions are compressed. QPC/QXL version 
comes on CD. Non CD versions DO NOW support digital sound on QPC2 


Quantum Leap €@ Drives 


After many years of unavailability, here they are again! These are 
high quality Mitsubishi constructed/IBM badged drives with full 
warranty. 

Unlike previously sold ED drives, these do not require 
FLP_JIGGLE and have no problems formatting 720K disks. 
However for the latter a switch is included with the cable. 


ED Bare unit (no cable) £ 29.99p 
ED Boxed unit (complete with cable/ PSU) £ 98.99p 
Single unit Cable (with switch) £ 4.99p 
Dual unit Cable (with two switches) £ 5.99p 
(More options available, contact us for details. Also available mass quantities 
of ED and DD disks!) 


for Windows 


For QLers that run Windows or with incompatible hardware for 
Talent Games, we now have re-released these adventures so that 
they can run on your Windows-equipped PC. No Emulator, 
floppies, microdrive backups etc. required, just a one-click install! 
Ofcourse the full QL line is still available! (See side column) 


Talent Games for Windows ea £10.00p 
(Each Game includes a runtime installation of QLA¥-2 by Jimmy Montesinos} 


RAP 


Old Favourites! 


Utilities 


Sidewriter v1.08 £ 10.00p 
Landscape Printing (EPSON printers) 

ImageD v1.03 £10.00p 
3D object generator 

Q-Help v1.06 £10.00p 
Superbasic On-Screen help system 

Q-Index v1.05 £ 5.00p 
Keyword-to-topic finder 

ProForma ESC/P2 Drivers v1.04 for ProWeSs £ 8.00p 
Printer Driver 


Applications 


Flashback SE v2.03 (upgrade only) £ 5.00p 
Database 
QL Cash Trader v3.7 £ 5.00p 
Accounting/Finance 
QL Payroll v3.5 £ 5.00p 
Accounting/Finance 
QL Genealogist v3.26 £ 20.00p 
Genealogy 
Genealogy for Windows £ 50.00p 
QL Genealogist to Windows version upgrade 
QL Cosmos v2.04 
Planetarium 
Q-Route v2.00 
Route Finding 
Upgrade from v1.xx 
Britain map v1.11 
BIG Britain map (needs 2Mb) v2.03 
Various Britain Area maps (ask for details) 
lreland map v1.00 
Belgium map v1.01 
Catalonia map v1.03 
P-Word UK English Dictionary (500.000 words!) 
Dictionary 


Leisure 


Return to Eden v3.08 
Adventure 
Nemesis MkIil v2.03 
Adventure 
The Prawn v2.01 
Adventure 
Horrorday v3.1 
Adventure 
West v2.00 
Adventure 
The Lost Kingdom of Zkul v2.01 
Adventure 
All 6 games above £ 25.00p 


D-Day Mkil v3.04 £10.00p 
Strategy/War Simulation 
Grey Wolf v1.08 £ 8.00p 
Graphical Submarine Simulation 
Wer in the East Mkil v1.24 (upgrade only) 5.00p 
Strategy/War Simulation 
Open Golf v5.20 8.00p 
Sports Simulation 
QuizMaster Ii v2.07 5,00p 
Quiz 
Stone Raider il v2.00 5.00p 
Arcade Game 
Hoverzone v1.2 5.00p 
Arcade Game 
Deathstrike v1.5 5.00p 
Arcade Game 
Flightdeck v1.0 £10.00p 
Flight Simulation 

All 6 games above (Open Golf, QuizMaster II,Stone 

Raider Ii, Hoverzone, Deathstrike and Flightdeck) £ 28.00p 


Notes on Software requirements 
The following programs have a minimum SGC card requirement: P-Word, 
Qword, Big Britain MAP for Q-Route 


35 Chantry Croft, Kinsley, Pontefract, West Yorkshire, WF9 5JH, United Kingdom Tel: +44 1977 610509 (From the UK dial: 01977 610609) 


Website: http://www. rwapservices.co.uk 


{For PayPal please add 4% to the total price. Cheques in £ sterling made payabie to R. Mellor) 
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* On entry, Al contains the address of the source string as this can be 

* either an entry in the reg_table (for data register lists) or the input 
* buffer if we are decoding the address register lists. 

* 

* Corrupts D3, A2 and Al - all of which are working registers and we 

* don't care ! 

* 


t27_append move.wW d4,-(a7) ; Preserve the register list mask 


a 
lea output, a2 3; Destination string 
move.wW a6, (a2) 3 Save the string size correctly 
add.w (al) ,d6 ; Update resulting string length 
bsr str_append 3 Append the string to the buffer 
move.w (a7)+,d4 3; Restore the register list bitmap 
rts 


The following line should be added to your source code. It pulls in the file we created above containing 
all the decoded register lists. By generating it into a separate file as automagically as possible, then 
including it, we have less typing to do to get it all included in the source code. 


've added the following just after the end if the type 31 code and just above the cond_code routine 
which decodes the various condition codes. 


% 


* Insert the register list decoding tables next 
¥ 


in wini_source_QLTdis_reglist_asm 


Some changes are required in the addr_reg and data_reg routines as well. Change both of those 
routines to the following code. 


Note, if you decided in the SuperBasic code above that your registers would be in lower case, then in 
the following code, at label ar_d2a, you'll need to replace the 'D’ in cmpi #'D'(a3) with a ‘d’ and change 
the ‘A’ to ‘a’ two lines further on. 


* 
* ADDRESS Register list routine. Returns the address of the decoded address 

* register list in A3.L. On entry, requires a register list bitmap byte in DA. 
* Also returns DO = 0 and Z set if no errors, or Z unset and DO = ERR_BP if 

* there is nothing in the register list to decode. 

* 


addr_reg tst.b a4 ; Nothing to do if D4 is zero 
beq.s ar_nothing 3 Thought so ! 
move.w d4,-(a7) ; Preserve the register list bitmap 
bsr.s reg_list ; Returns A3 as a reg list string pointer 


* At this point, A3 holds the address of the decoded string but it has DATA 
* register names in it. We need to copy it to the input buffer, convert from 
* DATA to ADDRESS registers by replacing all 'D' with 'A' then copy the 

* resulting string to the output buffer. 


movem. 1 al—a2,-(a7) Save the workers 


, 
movea. 1 a3,al 3; From address 
lea buffer, a2 3; To address 
bsr str_epy 3 Copy the string to the input buffer 
movem.1 (a7)+,al—a2 3; Restore the workers 
lea buffer, a3 3; Start of string = word count 
move.w (a3)+,d4 3; Size of string 
bra.s ar_d2a_end 3; Skip 
ar_d2a empi.b #'D', (a3) 3 Found a 'D' ? 
bne.s ar_d2a_next 3 Fraid not 
move.b #'A', (a3) 3; Yes, change it 
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ar_d2a_next adda.1 


#1,a3 ; Next character in buffer 


ar_d2a_end dbra d4,ar_d2a 3; Do rest of buffer 
move.w (a7) ,d4 3; Restore register list bitmap 
elr.1 do 3; No errors 
bra.s ar_exit 3; Finished. 
ar_nothing moveq #ERR_BP , dO 3; Nothing to decode = bad parameter 
ar_exit tst.b do 3; Set or clear Z accordingly 
rts 3; Return with A3 -> register list string 
¥ 
* DATA Register list routine. Returns the address of the decoded data register 
* list in A3.L. On entry, requires a register list bitmap byte in D4. 
* Also returns DO = 0 and Z set if no errors, or Z unset and DO = ERR_BP if 
* there is nothing in the register list to decode. 
% 
data_reg tst.b a4 3; Nothing to do if D4 is zero 
beq.s dr_nothing 3 Thought so ! 
bsr.s reg_list 3; Returns A3 as a reg list string pointer 
elr.1 do 3; No errors 
bra.s dr_exit ; Finished. 
dr_nothing moveq #ERR_BP , dO 3; Nothing to decode — bad parameter 
dr_exit tst.b do 3; Set or clear Zero flag accordingly 
rts 


The old code at routine reg_list should be deleted and the following inserted in its place. All the old 
code from reg_list down to (and including) label rl.done should be replaced with the following: 


Pe sr 
* Register list routine. This returns A3 as a pointer to a register list string 
* according to the value of the register list bitmap passed in DA.B. 
x 
* Because there is no entry in the table for zero, we must adjust the entry we 
* want to account for this. The register list for a bitmap with the value of 
* one is in position zero of the reg_off table and so on. We must subtract 1 
* from the bitmap value to get our proper table entry number in the reg_off 
* table. D4.B is guaranteed to be between 1 and 255. 
* 
reg_list lea reg_off,a3 3; Offset table in A3 
subq.b #1, 04 3; Adjust to correct table entry 
ext.w d4 3; D4 needs to be word sized 
lsl.w #1,d4 3; Double D4 - each entry is two bytes 
adda.w d4,a3 3 A3 points to the correct offset word 
move.w (a3), d4 3 Extract the offset 
lea.l reg_table,a3 3; Start of the decoded reg list table 
adda.w d4,a3 3 Correct string address in A3 
rts 


The diss_asm file should now be saved. The 
remainder of the code is the reglist_asm file crea- 
ted by the SuperBasic procedure at the begin- 
ning of this article. 


If you decided to go for the ‘no typing at all 
version, skip to the bottom of the code - you 
don't need to type anything. If you decided to be 
a martyr to the cause, then read on... 


The file reglist_asm, generated in part above, 
should look like the code below. To save space, | 
will not be importing the entire reg_off (register 
offset) table here. There is no need as the table 
was generated by the small program above. Suf- 
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fice to say that it starts at label r_1 and stops at 
r_255 with every entry in between catered for To 
save wasting paper, 'm only showing the first and 
last 5 entries here. 


As mentioned above, each entry Is a single word 
of data representing the offset of the decoded 
string - the register list - for each register list 
bitmap byte in a MOVEM instruction. There is no 
list if the value is zero, so we don't have an entry 
for zero - in case you were wondering. 


reg off equ * 


ri de.w mml_1—reg_table 
r2 de.w mml_2-reg_table 
r-3 de.w mmnl_3—reg_table 
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TA de.w mml_4—reg_table 

r_5 de.w mml_5—reg_table 

r_250 de.w mml_250-reg_table 
r_251 de.w mml_251-reg_table 
r_252 de.w mml_252-reg_table 
r_253 de.w mml_253-reg_table 
T_254 de.w mm1_254—reg_table 
r_255 dce.w mml_255—reg_table 


Stop typing for a bit! 


That's the easy bit done. Now for some serious 
typing (if this isn't on a floppy disc somewhere in 
the magazine that is!) 


We have the next table, this is the actual register 
list table, into which the table above provides us 
with an entry offset. This table has been partially 
written by the small SuperBasic routine above, 
but you still have to fill in the decoded strings 
yourself. Thankfully, you don't have to do as much 
typing as at first imagined. Currently, it looks 
similar to this: 


reg_table equ * 

mmi_1 de.w  mml_2-mml1_1-2 
de.b 'pt 

mmn]_2 de.w mmn1_3-mm1_2-2 
de.b 'pt 

mmi_3ss de.w mmn1_4—mm]_3-2 
de.b 'pt 

mm1_254 de.w mm1_255—mm1_254-2 
de.b 'pt 

mm1_255 de.w mm1_256-—mm1_255-2 
de.b 'pt 

mm1_256 equ * 


As ever, I've got the assembler to count up the 
String sizes for me, that's what computers are for 
after all. The calculation fills in the word length of 
the decoded register list string so that | don't 
have to remember to count up the size of each 
String and physically type it in. 'm a bit lazy by 
nature! 


Unfortunately, we still have 255 different register 
list strings to type in, but at least the first letter is 
done for us. Note that the code in the address 
register list decoding routine will scan the string 
and replace all 'D' with ‘A’ so if you prefer 
lowercase register names, change it here and in 
the code above. 


Lets get it over with. I've split the following table 
up into groups of 10 so that it is a bit easier to 
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follow in the listing. Hopefully, Jochen will not 
reformat it as one big chunk. | don’t know about 
you, but | used to hate typing in all that hex data 
(before | had an assembler) where the author (or 
publisher) had set it out in one huge block of data. 


Ok, you can start typing again, remember, all you 
need is the bit in the second line of each entry, 
the rest is already there for you. 


reg_table equ * 

mml_i de.w mmnl]_2-mml_1-2 
de.b "Do! 

mml_2 de.w mml1_3—mm1_2-2 
de.b 'pi' 

mml_3 8 de.w mm1_4—mm1_3-2 
de.b 'DO-D1' 

mml4 de.w mm1_5—mm1_4-2 
de.b 'p2' 

mm1_5 dc.w mml_6—mm1_5-2 
de.b 'DO, D2! 

mml_6 de.w mm1_'7-mm1_6-2 
de.b 'Di-D2' 

mml_'7 de.w mm1_8—mm1_7-2 
de.b 'pO-D2' 

mm1_8 de.w mm1_9-mm1_8-2 
de.b 'D3! 

mml_9 de.w mm1_10-—mm1_9-2 
de.b 'DO, D3! 

mml_i10 dce.w mmn1_11—mm1_10~-2 
de.b 'D1,D3' 

mml_11 dc.w mnl_12-mml1_11-—2 
de.b 'DO-D1, D3! 

mml_i2 dc.w mm1_13-mm1_12-2 
de.b 'D2-D3 '! 

mml_13 de.w mm)_14—mm1_13—2 
de.b 'DO, D2-D3 ' 

mm1_14 de.w mm1_15-mm1_14-2 
de.b 'D1—D2-D3'! 

mml1_15 de.w mm1_16-mm1_15-2 
de.b 'DO-D3' 

mml_16 de.w mm1_17—mm1_16—2 
de.b "D4! 

mmi_17 dc.w mnl_18-—mm1_1'7—2 
de.b 'DO, D4! 

mml_18 dce.w mnl_19-—mm1_18-2 
de.b D1, D4! 

mm1_i9 dc.w mm]_20-mm1_19-2 
de.b 'DO-D1,D4! 

mml_20 dce.w mm1_21-mm1_20-2 
de.b 'D2,D4! 

mml_21 de.w mml_22—mm1_21-2 
de.b 'DO,D2,D4' 

mml_22 dce.w mml_23-mm1_22-2 
de.b 'D1—D2,D4! 

mml_23 de.w mm]_24—mm]_23-2 
de.b 'DO-D4' 

mml_24 de.w mm1_25—mm1_24—2 
de.b 'D3-D4! 

mm1_25 dce.w mml_26-mm1_25-—2 
de.b "DO, D3-D4! 

mml_26 de.w mm1_2'7-mm1_26-2 
de.b 'D1,D3—D4' 

mmi_27 dc.w mn]_28-—mm1_ 27-2 
de.b 'DO-D1,D3-D4' 

mmi_28 dc.w mm) _29—mm1_ 28-2 
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The Bulletin Boards System - Help required! 


Well, the BBS or Mailbox Is giving me a headache, for quite a while now. 

| just don't find the time to maintain it, and although | see the machine every 
day and check the faxes (they are received by the Mailbox system too) | 
hardly ever log in. Whenever | start to log in regularly, there is no mail, and | 
give up after some time. 

Sorry, but that’s the way it is. E-Mail has completely taken over the BBS 
message system. 


But that's not the only problem - BBS maintainance in general is something | 
rarely find the time. News spread much easier over the net too. 


The only real reason so far was to have to BBS running for free software 
updates and upgrades. But | am also thinking about finding a better solution 
for this too, where the net comes into play. 


The problem is: | do not know how to move the functionality of the group | 
download restrictions onto the web. 
What | need is some kind of ASP script or so, where users can register and 
log in via username and password (provided by me) and where | can assign 
every user the rights to access the download of individual files (e.g. specify | 
user X can download QD and QSpread updates, user Y can download FiFi 
and QD etc) 

The complete requirements (traffic limits, download limits, how to ensure that 
the downloadable files are not publicly available) need to be discussed, of 
course. 


| am not a web expert, so | am wondering if any of you, the readers, have 
more knowledge and can help? 


More and more users ask for web updates, and | think it is about time to 
move from the BBS to an internet based update service, if that is possible 
somehow. 


Well, | am somehow prepared to do it now, but | don't know how ... maybe 
somebody else has got an idea? 


a feedback please to studi alg com 
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mml_29 
mm]_30 


mm1_31 
mmi_32 
mm1_33 
mm1_34 
mm1_35 
mml_36 


de.b 
de.w 
de.b 
de.w 
de.b 


de.w 
de.b 
de.w 
de.b 
de.w 
de.b 
de.w 


de.w 


de.b 
de.w 


de.b 


de.b 


'D2—D4! mml_62 dc.w 
mm1__30—mm1_29-2 de.b 
'DO,D2—-D4' mm1_63 de.w 
mmni_31—mml_ 30-2 de.b 
'D1-D4! mm) 64 de.w 
de.b 
mm]_32—mm1_31-2 mml1_65 de.w 
'DO-—D4! de.b 
mm)_33—mml1_32-2 mml_66 de.w 
"D5! de.b 
mm]_34—mm1_33-2 mml_67 de.w 
'po,D5! de.b 
mm1_35—mm1_34-—2 mmi_68 de.w 
'p1,D5' de.b 
mm1_36—mm1_35—2 mml_69 de.w 
'po-D1,D5' de.b 
mm1_37—mml_36-2 mml1_70 de.w 
'D2,D5! de.b 
mm1_38-mm1_3'7-2 
'p0,D2,D5! mml1_71 de.w 
mm1_39-mm1_38-2 de.b 
'D1-D2,D5! mml1_72 de.w 
mm1_40—mm1_39-2 de.b 
'DO-D2,D5! mm1_73 de.w 
mm1_41-mm1_40-2 de.b 
'D3,D5! mm1_74 dce.w 
de.b 
mm1_42-mm1_41-2 mml_75 de.w 
'DO,D3,D5! de.b 
mml_43—mm1_42-2 mm1_76 de.w 
'D1,D3,D5' de.b 
mm]_44—mm1_43-2 mml_77 de.w 
'DO-D1,D3,D5' de.b 
mm1_45-mm1_44-2 mm1_78 dc.w 
'D2-D3,D5' de.b 
mm1_46—mm1_45-2 mm1_79 de.w 
'DO,D2-D3,D5' de.b 
mm1_4'7—mm1_46-2 mml_80 dc.w 
'D1-D3,D5' de.b 
mm1_48-mm1_47-2 
'DO-D3,D5' mml1_81 dc.w 
mm1_49-mm1_48-2 de.b 
'D4A-D5! mml_82 dc.w 
mm1_50-mm1_49-2 de.b 
'DO,D4—D5! mml1_83 dc.w 
mml1_51-mm1_50-2 de.b 
'D1,D4—D5! mml_84 de.w 
de.b 
mm1_52-mm1_51-2 mml_85 dce.w 
'DO-D1,D4—D5' de.b 
mm1_53—mm1_52-2 mm1_86 de.w 
'D2,D4—D5! de.b 
mml_54—mm1_53-—2 mnl_87 dc.w 
'DO,D2,D4—D5! de.b 
mm1_55—mm1_54-2 mml1_88 dc.w 
'D1-D2,D4—-D5! de.b 
mm]1_56-mm1_55-2 mmi_89 dc.w 
'DO-D2,D4—D5'! de.b 
mm1_5'7-mm1_56-2 mm1_90 de.w 
'D3-D5! de.b 
mm1_58—mm1_57-2 
'DO, D3—D5! mml1_91 de.w 
mm1_59-—mm1_58-2 de.b 
'D1,D3—-D5' mml_92 de.w 
mm1_60-—mm1_59-2 de.b 
'DO-D1,D3-D5' mml_93 de.w 
mml_61—mm1]_60-—2 de.b 
'D2-D5! mml1_94 de.w 
de.b 
mm1_62-mm1_61-2 mml1_95 dc.w 
'DO,D2-D5' de.b 
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mml_63-—mm1_62-—2 
'D1-D5' 
mm1_64—mm1_63—-2 
'DO-D5! 
mm1_65—mm1_64—2 
"D6! 
mm1_66-mm1_65-—2 
'DO,D6! 
mm1_67—mm1_66-—2 
'D1,D6! 
mm1_68-mm]_67—2 
'DO-D1,D6' 
mm1_69-mm1_68—2 
'D2,D6' 
mm1_'70-mm1_69—2 
'DO,D2,D6! 
mml_'71—mm1_'70-2 
'D1-D2,D6' 


mm]_72—mm1_71-2 
'DO-D2, D6! 
mm1_73-mm1_72—-2 
'D3,D6! 
mm1_'74—mm1_73—2 
'DO,D3,D6! 
mm]_'75—mm1_'74—2 
'D1,D3,D6! 
mm1_'76—mm1_75—2 
'DO-D1,D3,D6! 
mm1_7'7—mm1_76—2 
'D2-D3,D6! 
mm1_'78—mm1_'77—2 
'DO,D2-D3,D6' 
mm1_79—mm1_78-2 
'D1-—D3,D6' 
mm1_80-—mm1_'79-2 
'DO-D3, D6! 
mmi_81-—mm1_ 80-2 
'D4,D6! 


mm1_82-mm1_81-2 
'DO,D4,D6! 
mn1_83—mm1_82-—2 
'D1,D4,D6! 
mml1_84—mm1_83-2 
'DO-D1,D4,D6' 
mm1_85-mm1_84—2 
'D2,D4,D6! 
mm1_86-mm1_85—-2 
'DO,D2,D4,D6' 
mm1_8'7-mm1_86-—2 
'D1—D2,D4,D6' 
mm) _88—mm1_87—2 
'DO-D2,D4,D6! 
mnl_89—mm1_88-—2 
'D3—D4,D6! 
mm1_90-mm1_89-2 
'DO,D3—D4,D6! 
mml_91-mm1_90-2 
'D1,D3—-D4,D6! 


mml_92—mm1_91-2 
'DO-D1, D3-D4, D6! 
mm1_93-—mm1_92-2 
'D2-D4,D6! 
mm1_94—mm1_93-2 
'DO,D2-D4,D6! 
mm1_95—mm1_94-2 
'D1-D4, D6! 
mm1_96-mm1_95-2 
'DO-D4,, D6! 
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mm1_96 
mm1_97 
mm1_98 
mm1_99 
mm1_100 


mml_101 
mml_102 
mm1_103 
mm1_104 
mm1_105 
mm1_106 
mam1_107 
mm1_108 
mm1_109 


mm1_110 


mmj_111 
mmi_1i2 
mm1_113 
mm1_114 
mmi_115 
mm1_116 
mm1_117 
mm1_118 
mm1_119 


mm1_120 


mm]_121 
mm1_122 
mml_123 
mm1_124 
mm]_125 
mm1_126 
mm1_127 
mm1_128 


mm1_129 


Chon ornon os 


eho ktokoktoktokototoktaos 
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mm1_97—-mm1_96-2 
'D5-D6! 
mm]_98-mm1_97-2 
'DO,D5—D6' 
mm1_99-mm1_98-2 
'D1,D5-D6! 
mm1_100-mm1_99-2 
'DO-D1,D5-D6' 
mm1__101-—mm1_100-2 
'D2,D5-D6' 


mm1_102—mm1_101-2 
'DO,D2,D5-D6' 
mm1_103—mm1_102-2 
'D1—-D2,D5-D6' 
mm1_104—mm1_103-2 
'DO-D2,D5-D6! 
mm1_105-mm1_104-2 
'D3,D5—D6' 
mm1_106-—mm1_105-2 
'DO,D3,D5-D6' 
mm1_107-mm1_106—2 
'D1,D3,D5-D6'! 
mm1_108~—mm1_107—2 
'DO-D1,D3,D5-D6' 
mm1_109-—mm1_108-2 
'D2-D3 ,D5-D6' 
mm1_110-mm1_109-2 
'DO,D2-D3,D5-D6' 
mm1_111—mm1_110-2 
'D1-D3,D5—D6! 


mm?_112-—mm1_111-2 
'DO—D3,D5-D6! 
mm]_113-mm1_112-2 
'D4—D6! 
mm]_114—mm1_113-2 
'DO,D4—D6! 
mm1_115-mm1_114-2 
'D1,D4—D6' 
mm1_116-mm1_115-2 
'DO-D1,D4-D6' 
mm1_117—mm1_116-2 
'D2,D4-D6'! 
mm]_118-—mm1_117-2 
'DO,D2,D4—-D6' 
mm1_119-mm1_118-2 
'D1-—D2,D4—-D6' 
mm1_120-mm1_119-2 
'DO-D2,D4—D6' 
mm1_121-mm1_120-2 
'D3-D6! 


mml_122—mm]_121-2 
'DO,D3-D6' 
mm1_123-mm1_122-2 
'D1,D3-D6' 
mm]_124—mm]_123-—2 
'DO-D1,D3-D6! 
mm1_125-mm1_124-2 
"D2-D5-D6! 
mml_126-mm1_125-2 
'DO, D2—D5—D6! 
mm]_12'7—mm1_126-2 
'D1-D6! 
mm]_128—mm1_127-2 
'DO-D1-D6' 
mm1_129-mm1_128-2 
'p7t 
mm1_130—mm1_129-2 
'DO, D7! 


mm1_130 


mm]_131 
mm1_132 
mm1_133 
mm1_134 
mm1_135 
mm1_136 
mnl_137 
mm1_138 
mm1_139 


mm1_140 


mm1_141 
mm1_142 
mm1_143 
mm1_144 
mm1_145 
mm1_146 
mm1_147 
mm1_148 
mm1_149 
mm1_150 


mm1_151 
mmi_152 
mm1_153 
mm1_154 
mm]_155 
mm1_156 
mml_15'7 
mm1_158 
mm1_159 


mm1_160 


mm1_161 
mm1_162 


mm 163 


de 
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mm1_131—mm1_130-2 
'D1,D7' 


mm]_132-mm1_131-2 
'DO-Di, D7' 
mml_133—mmi_132-2 
'D2,D7! 
mm1_134—mm1_133-2 
'DO,D2,D7' 
mm1_135-mm1_134-2 
'Di-D2,D7' 
mm1_136-mm]_135-2 
'DO-D2, D7! 
mm]_137—mm]_136-2 
'D3,D7' 
mnl_138-mm1_137-2 
'DO,D3,D7' 
mm1_139-—mm1_138-2 
'D1,D3,D7' 
mm1_140—mm1_139-2 
'DO-D1,D3,D7' 
mml_141-mml_140-2 
'D2-D3,D7' 


mm1_142-mm1_141-2 
'DO, D2-D3, D7! 
mm1_143-mml_142-2 
'D1-D3,D7! 
mml_144—mm1_143-2 
'DO-D3, D7! 
mm1_145—mm1_144-—2 
'D4,D7! 
mm1_146-—mm1_145-—2 
'DO,D4,D7! 
mm1_147—mm1_146-2 
'D1,D4,D7! 
mm1_148—mm1_147~2 
'DO-D1,D4,D7! 
mm1_149-mm1_148-2 
'D2,D4,D7' 
mm1_150-mm1_149-2 
'DO,D2,D4,D7! 
mml_151-—mm1_150-2 
'D1—D2,D4,D7! 


mmi_152-mml_151-2 
'DO-D2,D4,D7' 
mm1_153-mm1_152-2 
'D3-D4, D7! 
mm1_154—mml_ 153-2 
'DO,D3—D4, D7! 
mm1_155-mm1_154-2 
'D1i,D3-D4,D7! 
mml_156—mm1_155-2 
'DO-—D1,D3—D4, D7! 
mm1_15'7—mm1_156-2 
'D2—D4,D7! 
mml_158—mm1_157-2 
'DO,D2-D4,D7' 
mm1_159-mm1_158-2 
'D1-D4,D7! 
mm1_160-mm1_159-2 
'DO-D4 , D7! 
mmi_161—mm1_160-2 
'D5,D7' 


mml_162—mm1_161-2 
'DO,D5,D7' 
mm1_163-mm1_162-2 
'D1,D5,D7! 
mm1_164—mm1_163-2 
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'DO-—D1,D5,D7' 
mml_165—mm1_164-2 
'p2,D5,D7' 
mm1_166—mm1_165-2 
'DO,D2,D5,D7! 
mm1_167—mm1_166-2 
'pi-D2,D5,D7' 
mm1_168—mm1_167-2 
'p0-D2,D5,D7' 
mm]_169—mm1_168-2 
'D3,D5,D7' 
mmnl_1'70-mm1_169-2 
'DO0,D3,D5,D7' 
mm]_1'71—mm1_1'70-2 
'D1,D3,D5,D7' 


mmnl_172-mml_171-2 
'DO-D1,D3,D5,D7' 
mn1_173—mm1_172-2 
'D2-D3,D5,D7! 
mm1_174—mm1_1'73-2 
'DO, D2-D3,D5,D7! 
mm1_1'75-mm1_174—2 
'D1-D3,D5,D7' 
mm1_176-mm1_1'75-2 
'DO-D3,D5,D7! 
mm1_17'7—mm1_176-—2 
'D4-D5,D7! 
mn1_178-—mm1_1'77-2 
'DO,D4—D5,D7! 
mm1_179-mm1_178-2 
'D1,D4—D5,D7! 
mm1_180-—mm1_179-2 
'DO-D1,D4~—D5,D7! 
mm1_181—mm1_180-2 
'D2,D4—D5,D7' 


mm1_182-mm1_181-2 
'DO,D2,D4—D5, D7! 
mm1_i83—mm1_182-2 
'D1-D2,D4—D5,D7! 
mm1_184—mm1_183-2 
'DO-D2,D4—D5, D7! 
mm1_185—mm1_184-2 
'D3-D5,D7' 
mnl_186-—mm1_185-—2 
'DO,D3-D5,D7! 
mm1_18'7-mm1_186—2 
'D1,D3-D5,D7' 
mml_188—mm1]_187-2 
'DO-D1,D3-D5,D7' 
mmn]_189—mm1_188-2 
'"D2-D5,D7' 
mm)_190-—mm1_189-2 
'DO,D2—D5,D7'! 
mm1_191—mm1_190-2 
'D1-D5,D7' 


mm]_192-—mm1_191-2 
'DO-D5,D7' 
mm1_193-—mm1_192-2 
'D6-D7! 
mm1_194—mml_193-2 
'DO, D6—-D7'! 
mm1_195—mm1_194—2 
'D1,D6—-D7! 
mm1_196-mm1_195-2 
'DO-D1, D6-D7' 
mml_19'7—mm1_196-2 
'D2,D6—D7' 
mm]_198—mm1_197—2 


mml_198 
mm1_199 
mm1_200 


mml_201 
mm1_202 
mm1_203 
mm1_204 
mm1_205 
mm1_206 
mm1_207 


mmi_208 


mm1_209 
mmi_210 


mm1_211 
mm1_212 
mm1_213 
mm1_214 
mml_215 
mm1_216 
mm1_217 
mm1_218 
mm1_219 


mm1_220 


mml_221 
mml_222 
mm1_223 
mm1_224 
mml_225 
mm]_226 
mmn]_227 
mm1_228 
mm1_229 
mm1_230 


dc. 


de 


de. 


de 
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SHEE OZOL OE SEU E OES EYE 


SEOk CHORE OHO EOE OE GEESE 


'D0,D2,D6—-D7! 
mm1_199-mm1_198-2 
'D1-D2,D6—D7' 
mm1_200-mm1_199-2 
'DO-D2, D6—-D7' 
mm]_201—mm1_200-2 
'D3,D6—-D7! 


mm]_202-mm1_201-2 
'DO,D3,D6—-D7' 
mm1_203-—mm1_202-2 
'D1,D3,D6-D7! 
mm1_204—mm1_203-2 
'DO-D1,D3,D6-D7! 
mm1_205—mm1_204~-2 
'D2-D3, D6—D7! 
mml_206-mm1_205-2 
'DO, D2—D3 , D6-D7' 
mm1_207-mm1_206-2 
'D1-D3, D6—-D7! 
mml_208-—mm1_207-2 
'DO-D3,, D6—D7! 
mm1_209—mm1_208-2 


"D4, D6-D7! 
mm1_210—mm1_209-2 
'DO,D4,D6-D7! 
mm1_211-mm1_210-2 
'D1,D4,D6-D7" 


mm1_212-mm]_ 211-2 
'DO-D1,D4,D6—D7' 
mm1_213-mml_212-2 
'D2,D4,D6—D7! 
mm1_214—mm1_213-2 
'DO,D2,D4,D6-D7'! 
mm1_215—mm1_214-2 
'D1-D2,D4,D6-D7' 
mm1_216—mm1_215-2 
'DO—D2,D4,D6—D7! 
mm)]_217—mm1_216-2 
'D3—D4,D6—D7'! 
mml_218-mm1_217~2 
'DO,D3—D4, D6-D7'! 
mnl_219—mml1_218-2 
'D1,D3—D4,D6-D7' 
mml_220—mm1_219-2 
'DO-D1,D3—D4,D6—D7' 
mml_221—mm1_220-2 
'D2-D4,D6-D7' 


mml_222-mm1_ 221-2 
'DO, D2-D4 , D6-D7'! 
mml_223-mm1_222-2 
'D1-D4 ,,D6—D7! 
mm1_224—mml_ 223-2 
'DO—-D4 , D6—D7! 
mm]_225-mm1_224-—2 
'D5-D7' 
mm1_226-mm1_225-2 
'DO,D5-D7' 
mm1_227-mm1_226-2 
'D1,D5-D7'! 
mml_228-—mm1_22'7-2 
'DO-D1,D5-D7' 
mml_229-—mm1_228-2 
'D2,D5—D7' 
mmi_230—mm1_229-2 
'DO,D2,D5-D7' 
mm1_231—mm1_230-2 
'D1-D2,D5-—D7' 


QL loday 


mml_231 de.w mml_232-mm1_231-2 
de.b 'DO—D2,D5-D7' 

mm) 232 de.w mml_233-—mml_232-2 
de.b 'D3,D5-D7' 

mm1_233 de.w mml_234—mm]1_233-2 
de.b 'DO,D3,D5-D7' 

mm]_234 de.w mm]1_235-mm1_234-2 
de.b 'D1,D3,D5-D7' 

mml_235 de.w mm1_236-mm1_235-2 
de.b 'DO-D1,D3,D5-D7' 

mml_236 de.w mml_237—mml1_236-2 
de.b 'D2-D3,D5-D7' 

mm1_237 de.w mm1_238-mml_237-2 
de.b 'DO,D2-D3,D5-D7' 

mnl_238 de.w mm1_239-mm1_238-2 
de.b 'D1-D3,D5—D7'! 

mm1_239 de.w mm1_240—mml_239-2 
de.b 'DO-D3,D5—D7' 

mm1_240 de.w mm1_241-mm1_240-2 
de.b 'D4~—D7! 


mml_241 de.w mml_242—mml1_241~2 
de.b 'DO,D4—-D7' 

mm1_242 de.w mm1_243-mm1_242-2 
de.b 'D1,D4—D7! 

mmi_243 de.w mml_244—mm1_243-2 
de.b 'DO-D1,D4-D7! 

mm1_244 de.w mm1_245-mm1_244-2 
de.b 'D2,D4—D7! 

mm1_245 de.w mml_246-mml_245-2 
de.b 'DO,D2,D4—D7'! 

mm1_246 de.w mml_247-mml_246-2 
de.b 'D1-D2,D4-D7! 

mm1_247 de.w mm1_248-mm1_247-2 
de.b 'DO-D2,D4—-D7! 


mm1_248 de.w mml1_249-mm1_248-2 
de.b 'D3-D7' 

mm1_249 de.w mm1_250-—mm1_249-2 
de.b 'DO,D3-—D7' 

mml_250 de.w mml_251-mm1_250-2 
de.b 'D1,D3-D7' 


mmi_251 de.w mm1_252-mml_251-2 
de.b 'DO—D1,D3-D7' 

mml_252 de.w mml1_253-—mml_252-2 
de.b 'D2-D7' 

mm1_253 de.w mm1_254—mml_253-2 
de.b 'DO,D2-D7' 

mm1_254 de.w mm1_255-mm1_254-2 
de.b 'Di-D7' 

mm1_255 de.w mm1_256—mm1_255-2 
de.b 'DO-D7'! 

mm1_256 equ * 


And that's all there is to it! Hopefully, you have 
been saving this as you went along, now's the 
time to assemble it. 


| hope you realise that the code we have been 
typing over the last few issues, with a couple of 
‘missing’ articles, is working code. You can de- 
code most of the instruction set now - if not all of 
it. We still have a little way to go though, the 
separate printing nightmare is still to come :o) 


See you next time, where I'll be finishing off here 
(maybe) or | might even have something totally 
different. It will still be in assembler though, but, if | 
get it finished, it might even prove to be useful. 


Corrections 


Correction for an article in 
Volume 8 Issue 3 


David Bunbury writes: 

| expect that you (or somone else) will already 
have spotted an apparent mistake in the listing 
on page 43 of the October QT Today but, in 
case you have not, there is a problem with Line 
270, where the GET will advance the file pointer 
by 6 bytes instead of two. 

It works correctly if glbpl is made an INTEGER, 
which | presume was the intention. 

| think that | shall find this program rather useful, 
although not for Mode 32; | have modified it to 
work with mode 4 for use with an original 
"Black Box’. 


Thank you, David. Probably 
correction, to avoid having to rename all 
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occurrences of the variable ql_bpl, is to read 
the value initially into an integer variable then 
coerce to ql_bpl: 

270 GET #3,temp% : ql_bpl = temp% : REMark 
bytes per line in QL file 


Correction for an article in 


Volume 8 Issue 4 

There is an error in the listing on page 17 

(Calendar program). It's been pointed out we 

managed to lose a couple of lines from the end 

of the listing. 

Here is the correction: 

690 DATA 'JANUARY', 'FEBRUARY', 'MARCH', 
"APRIL', 'MAY', 'JUNE', 'JULY', 
'AUGUST', 'SEPTEMBER', 'OCTOBER', 
'NOVEMBER', 'DECEMBER' 

700 REMark number of days in months 


710 DATA 31, 28, 31, 30, 31, 30, 31, 
31, 30, 31, 30, 31 
the easiest 
Dilwyn Jones 
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PROGRAMMING 


QD 2003 £ 49,00 

QD + QBasic £ 63.00 
Typset 94 £29.00]) op + Qliberator + QBasic £ 104.00 
Fountext 94 £ 39.00 Qliberator £ 50.00 
2488 drivers £29.00] Master Spy v 3.3 £ 30.00 

QPTR £ 32.00 


Easyptr pt 1 & 2 (together) £ 30.00 
Easyptr pt 3 (C library) £ 14.00 


High Colour QMake £ 18.00 
Patch QMon /JMon £ 22.00 

: Basic Linker £ 22.00 
Available Now DISA 3 £34.00 
£9.00 QMenu £ 16.00 


Many Happy 


This year is the twentieth birthday of the QL. Why not celebrate by treating 
yourself to all these colour upgrades. The Text 87 High Colour patch is 
released now - but dont forget it will only work with QPC2/QXL. Patches 
for other systems may follow but we need to know how many people are 
interested. Contact us if you are. 
There are still a few keyboard membranes available to get that old black box 
up and running again. 
For those of you who need a basic printer for your QL we can get the 
EPSON LQ-300+ which is a 24 pin Dot Matrix model with ESC/P2 
emulation. Price £135.00 plus shipping. Call for availability. 


Just Released! 
High Colour Drivers for Gold / Super Gold Card SMSQ/E 


(Aurora only - Send old master disk as proof of purchase} 
These programs are free upgrades : 
£25.00 Agenda 
pa 
Wine 
QL Keyboard Membranes EE 
Available Now ! QPAC 2 
£ 17.50 ea + P&P All Scrsivas of 


SMSQ/E(Gold Card/QX1L/Q40 
(Just send 75p for the disk and 80p 


postage + master as proof of ownershi 
UTILITIES | > : a 
FiFi 2 £21.00 These Programs are paid Upgrades: 
QSup £ 30.00 
QSpread 2003 £51.00 Qs d 
/QSpread 2001 to 2003 £ 10.50 
Cueshell 2 £ 15.00 QD 98 to 2003 £ 10.50 
Qload/Qref £15.00 - QPC2 S 
Disk Mate5 £16.50 | update from v3.xx Free 
QPAC 1 £ 22.00 | update from v2 £ 13.90 
QPAC 2 £ 42.00 update from vl £ 34.00 
one fo Return Master Disk With Order 


QLQ £ 30.00 
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Tel +44 (0) 1273-386030 fax +44 (0) 1273-430501 
| Mobile +44 (0) 7836-745501 


\ email qbranch@qbranch.demon.co.uk web ; http://w .gbranch.demon.co.uk 


soe 


O Branch 


Feeling out on a limb ? 

Reach out for QO Branch. 
Suppliers of Quality DDOS/SMSQ products 
Hardware and Software. 


Hardware 


We have a small stock of second user items. Auroras / 
bides / Gold Cards / Qpl / H tc. call 

20 LOCKS HILL, PORTSLADE, | sto get details of the items available. These are going 

E. SUSSEX. BN41 2LB. UK. ee 

QxL II £ 100.00* 


Recycled superHermes £ 65.00 * 
R'cycld SuperGold Card £ 110.00 
Recycled Gold Card £45.00 * 
Recycled Aurora £ 70.00™ 
Qubide £50.00* 
Qplane £ 5.00 
Aurora cables £3.00 
Aurorarom adaptor £3.00 
‘Arfa Braquet' £ 8.00 
‘Son of Braquet' £ 18.00 
The ‘Braquet' £ 16.00 
MC plate £ 6.50 
* when available. 
Call for details 


Qubide upgrades to version 2.01 £ 8.00 


Gold Card / Atari / QXL Version S M S Q/E 


Version 3.04 out now! 


ProWesS 


ProWess (now free !) £1.60 
DATAdesign £ 20.00 
Fontutils £ 28.00 
File Search £11.00 
PFlist £11.00 
Dilwyn's Fontpack £ Call 


LINEdesign v 2.16 £ 22.00 
PWfile £17.50 


Paragraph 


The ProWesS word processor 
Demo version £ 1.50 + postage 
Full Registered version £ 18.00 


now ! 


ersion 2.03 available 


Aurora High Colour 
version available now 


Now Only £32.00 upgrade £ 21.00 
— QPC 2 v3.11 - full colour version! 


Get Cueshell for only £15.00 with any copy of SMSQ/E 
or OPC 2 upgrade’! Now Only £ 65 .00 


Q Branch Programs 


The Knight Safe 3 £35.00 Q- Route v1.08C £ 25.00 


upgrades from previous versions £5.00 Route finding preercnuee 
Q - Count £25.00 The Fractal Collection £ 35.00 


Pointer driven home accounting 


Post and Packing is included with Software Prices 
Unless Otherwise Stated. 


We can accept payment by Visa, Mastercard and Switch. We also accept 
cheques drawn on a UK Bank in Sterling. 
You can also pay directly into our bank in Euros. 
Barclays Bank Acc# 79016888 sort code :20-71-02 Name :QBranch) 
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Windows in the Pointer 
Environment using SETW 


George Gwilt 


SETW is a program providing an easy way of 
defining windows for the Pointer Environment for 
both the new and old versions of WMAN. The 
program will run on all QL type machines from an 
AH rom with Trump Card to a Q60 or QPC. 


General 

One of the more annoying stumbling blocks to 
programming for the Pointer Environment is the 
production of the definition of the windows. A 
window definition for PE goes far beyond the 
simple size, position, ink and paper colours of 
SCR/CON. 

A full PE window definition contains a range of 
sizes for the main window and within each of 
these contains information about loose menu 
items and sub windows and their contents. The 
sub windows must be one of two types, either 
information, which is simply a defined area within 
the main window, or application, which can con- 
tain a menu and allows actions to be chosen 
from within it. 

The contents of sub windows can be text, 
sprites or blobs with patterns. 

The original aids to a programmer defining a win- 
dow are the Qmac macros for use with assem- 
bler language and the extension keywords of 
QPTR for use with SuperBASIC. In both cases 
the sizes, positions and origins of all the items 
have to be given directly as numbers. You can, of 
course, use squared paper to help in defining 
these numbers, but until you see the window 
displayed on the screen by the PE software you 
will not really know how it is going to look, or 
indeed whether it works at all. 

Unfortunately, for a proper display all the consti- 
tuent parts of the window must be compatible. If 
an object is defined to be outside its allotted 
area, even by so much as a pixel, the window will 
not appear. The PE software then collapses with 
the message ‘out of range’. 

Clearly this is very frustrating for the program- 
mer. 

This problem was addressed in both TurboPTR 
and CPTR by the programs SETF (in TurboPTR) 
and SETZ (in CPTR). These programs allow a 
programmer to specify the contents of a set of 
windows and to set the sizes and positions by 
manipulation on the screen. Thus the window is 
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built up under the programmer's eyes as he 
proceeds. Also each element in the window is 
forced to be within acceptable limits. For exam- 
ple, text cannot be set to be partially outside the 
window or sub window which must contain it. 
SETF and SETZ thus allow a visual development 
of the window and its contents. When the 
operation is complete all the windows are shown 
in turn as they will appear when used by the 
program for which they are designed. 

Both SETF and SETZ and their use are described 
in two articles in QL Today. The first, on page 39 
Vol 7 Issue 4, contains in an Appendix a note of 
the operations of SETF as seen by a program- 
mer. In the second, on page 12 of Vol 7 Issue 6, 
John Sadler shows in detail how SETZ can be 
used to produce a working program. 


SETW 

The new version of WMAN, which appeared first 
in SMSQ/E v3.00 and which will presumably in 
due course be made available also to other QL 
operating systems, contains such a range of ex- 
tensions in the definitions of colours and sprites 
that an update of SETF and SETZ became es- 
sential. 

So extensive are the changes to both colours 
and sprites that | had thought first of producing 
two new versions for both SETF and SETZ for 
the new WMAN, leaving the original programs for 
use with the old WMAN. | judged this to be too 
confusing, so instead | have produced just one 
program, SETW, combining all the four features. 
The new program SETW is thus a combination of 
the two previous programs SETF and SETZ. It 
produces output suitable for both TurboPTR and 
CPTR. SETW also tailors the output to the type 
of WMAN present when it is run. 


Output 

SETW produces two files as output with names 
ending in _WDA and -z. They are first a set of 
DATA lines incorporating the complete window 
definition in a form suitable for TurboPTR, and 
second a set of C instructions suitable for CPTR. 
(See John Sadler's article mentioned above) 
Although the _WDA file is not needed to produce 
a C program via CPTR, it is neverless useful in 
that the program “SEEWIN” can be used to 
display the window. This is particularly useful 
where colours are set to the system palette de- 
faults. In this case the new feature of "SEEWIN’ 
allowing specification of a particular system pa- 
lette can be used to view the window with 
different colours for the defaults. 
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Also the _z file of C instructions is not used by 
TurboPTR, but is effectively a useful record of the 
values of the various items in the window defini- 
tion. 


Colours and Sprites 

Since the operation of SETW is essentially the 
same as that for both SETF and SETZ | will not 
describe it in detail here. However the new 
colours and sprites required some revision-of the 
process and these advances are dealt with here. 
When a colour is to be chosen SETF/Z shows 
one block of colour along with a description. The 
full range of QL colours available can be seen, 
one at a time, by using the up and down arrow 
keys. 

In place of this SETW shows a window contai- 
ning 16 colours from the full range. The colour 
currently selected is indicated by its description 
being white and not green like the others. Also 
there is a scroll bar to the right of the window 
which shows the proportion of the full range 
shown in the window and its position. Selecting a 
colour is achieved as before by pressing the up 
and down arrows. In addition if ALT is pressed 
too, the display alters by a window depth. 

The same process, incidentally, applies to the 
selection of an item from the user's list of text 
items. 

As with the colours, SETF/Z presented the user 
with just one sprite and its description. Movement 
through the total list of available sprites was done 
as for colours by using the up and down keys. 
SETW shows as many sprites as will fit into the 
display window and allows selection by use of 
the up and down keys. However. in this case the 
ALT key has no effect. 


New and Old WMAN 


Colours 

The old WMAN only caters for the byte range of 
QL mode 4/8 colours. The new WMAN has se- 
ven types of definition of colour which can be 
used in the window definition. These are de- 
scribed in the article by Wolfgang Lenerz on 
page 47 of Vol 8 Issue 2 of QL Today. They are 
represented by SETW as: 


Default (System Palette) 
COLOUR_QL 

Gray Scale 

COLOUR_PAL (Palette) 
COLOUR_PAL & Stipp! (Palette & Stipple) 
COLOUR_24 (RGB) 

Border 
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When a colour is to be chosen and SETW de- 
tects the presence of the new WMAN, it displays 
first a window giving the choices shown above. 
Unless Default is chosen, a new window appears. 
In the case of COLOUR_QL, Gray Scale and 
COLOUR_PAL the window now contains the first 
16 colours in the range chosen. For COLOUR_QL 
the range is exactly the same as for the old 
SETF/Z. For Gray Scale the range covers the 63 
different shades. COLOUR_PAL has a range of 
256. 

lf one of the remaining colour types is selected, 
an outside program is called. Currently these 
three programs merely ask for the values of the 
three parameters in each type. No colour is 
displayed in advance though when the choice is 
made the result is shown and the option is 
available to try the selection again. 

The “Default” option sets a particular entry to the 
system palette depending on what the colour is 
to be used for The actual defaults are shown in 
an Appendix below. 


Sprites 

Under the new WMAN the number of system 
sprites has been increased from 8 to 38. Many of 
these additional sprites, such as ’F2” are already 
available in C68 and are incorporated into the file 
cptr_o used by CPTR. To avoid duplication, a 
new, shorter, file called cptr2_0 has been pro- 
duced. The sprites displayed for choice by 
SETW are, for both old and new WMAN, first the 
system sprites (8 or 38 in number), followed by 
the sprites selected by the user and finally the 
sprites included in cptr_o or cptr2_o as appro- 
priate. 

With the new WMAN, any of the sprites can be 
used for a loose item, a window sprite for the 
main window or a subsidiary application window 
and finally for an item in an information window. 
There is one proviso regarding TurboPTR. A sys- 
tem sprite used as a loose item must be one of 
the first ten loose items for the old WMAN and 
28 for the new WMAN. 

Under the old WMAN there are more restrictions. 
The use of system sprites is restricted to loose 
items. They can't be used as window sprites, or 
items in an information window. Furthermore, in 
addition to being restricted to the first ten loose 
items in TurboPTR, only the move and resize 
sprites can be used in CPTR, any other system 
sprites selected and used in TurboPTR are 
forced to the default arrow sprite. 
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Appendix 


Default Colours 


One of the colour options in the new WMAN is 
the system palette. The value of the ‘colour’ in 
this case is the number of an entry in the palette. 
The actual colour in a program used will be the 
value of the particular entry in the system palette 
set to the program at run time. 


In order to allow some uniformity of practice the 
various entries in a system palette are assigned 
specific names. The subset of the 57 entries 
currently available used as defaults by SETW are 
given below: 


Main Window Border $200 
Main Window Paper $201 
Loose Item Border $207 


We received an interesting email from Simon 
Goodwin in response to some of the articles in 
the last issue. Here is a slightly edited version, 
with my responses in italics where | thought 
appropriate - Editor. 


Launchpad Cover Disk 

Pity Launchpad is dependent on the PE, and 
therefore no use to me. However the generic 
(non-PE) parts of QL Today are still much appre- 
ciated. 

We do try to cater for both PE and non-PE 
users, but the majority of material received for 
publication does seem to be PE orientated. We 
would, however, happily publish more non-PE 
material if more were to be sent to us! What do 
you the readers think about this - do you think 
we have the balance about right, or do you 
wish to see more of one or the other? 


QL Printers 

You might usefully add some Brother printers to 
your list. | use an HL-1050 laser (£100 second 
hand about three years ago) and there are many 
similar models (HL-1030, 1040, 1070, 1240, 1250, 
1270N). 

Its an uncommonly cross-platform compatible 
printer - like the HL-1070 but with only one paper 
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Available —- Paper $208 
Available -— Ink $209 
Selected ~ Paper $20A 
Selected — Ink $20B 
Unavailable - Paper $20C 
Unavailable -— Ink $20D 
Information Window Border $20E 
Information Window Paper $20F 
Information Window Ink $210 
Application Window Border $216 
Application Window Paper $217 
Menu Item Border $21A 
Available - Paper $21B 
Available -— Ink $21C 
Selected - Paper $21D 
Selected — Ink $21E 
Unavailable - Paper $21F 
Unavailable - Ink $220 
Seroll Bar $221 
Scroll Section $222 
Seroll Arrows $223 


input bin (the 1070 has two). The fast RISC pro- 
cessor is easily expandible with 72 pin SIMM 
memory (from 4 to 32 Mb) but unless you use big 
graphics at top resolution the internal 4 Mb will 
probably be enough. 

This printer has automatic HP-PCL and Epson 
ESC-P sensing, so it works with many PCL and 
Epson drivers, selecting the right emulation on 
the base of the first control codes it gets. So it 
works with the DIY Toolkit DeskJet drivers, Gold 
Card Epson drivers, and many others. 

It also automatically services parallel and USB 
ports by initially signing on as a USB printer and 
then sending a ‘disconnect’ message to the USB 
host if the parallel input port becomes active, 
printing that data then ‘reconnecting’ to the USB 
host after that job ends. 

This means it shares well between old and new 
computers with Centronics and USB printer inter- 
faces respectively, without need of a switch box. 
| use the parallel end on my Sam, Amiga Qdos 
and QL (via serial Centronics adapter) systems, 
with a switch box, and can drive the USB from 
UQLX (or Linux in general). 

A good source of information about which 
printers have brains (and therefore print text as 
fast as they can shift the paper unlike the Win- 
doze GDI ones that only accept bitmaps) is the 
guide at http://www.linuxprinting.org/ 

've found Roy Wood's complaints in QL Today 
misleading - there's still no shortage of printers 
compatible with Qdos, as long as you know what 
question to ask. | hope this information will helo 
others. 
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WHEN Variable 

WHEN variable is rather more robust on MG than 
on JS versions of Qdos. As it's primarily a de- 
bugging feature it's potentially useful on any 
system when you're not sure what's clobbering a 
variable. The HOW_COME PROCedure in Turbo 
Toolkit Demos and DIY Toolkit Volume B is handy 
for working out WHAT triggered the WHEN ex- 
ception. 

It is in all the Argos (Thor XVI OS) ROMs, with 
much the same level of functionality as on MG 
ROMs (surprise, surprise). It is not implemented in 
Turbo and not likely to be since it would involve 
inserting a conditional test on each write access 
to scalar variables, making every program that 
might use it substantially slower That said, per- 
haps it could be done setting the bottom bit (0) in 
the Vector Table entry for the variables you 
wanted to watch, and trapping the exception, but 
this would trap reads as well as writes and 
wouldn't work on a 68020 as that allows integer 
and floating point values to be at odd addresses 
(not that Turbo will ever put them there normally, 
as misaligned access is much slower). 


Stepping through TURBO Code 
George Gwilt does not appear to be aware of 
how to step through Turbo threaded code. The 
trick is to compile with size optimisation — this 
means that each template ends with a JMP 
instruction to shared code to fetch the next 
thread address, rather than have a copy of the 
six-byte threading routine at the end of each 
template. So a breakpoint on the generic in- 
Stance of this: 


move.w (a5)+,d0 
jmp 0(a6,d0.w) 
which appears in the first template 


(ENTRY_ROUTINE) and at the same offset at the 
start of every compiled program, picks up each 
code-generated instruction (CONSTANT_FLOAT, 
MULTIPLY ROM_FN etc) without the need to step 
through the code that implements the templates. 
Further reading: Turbo docs and open source! 

We brought this to George's attention and he 
has responded to this in the following article. 


Tiptoeing Through Turbo 


George Gwilt 


| am always glad to hear of better ways of doing 
things, especially from Simon Goodwin who 
unfailingly hits all nails on the head. So when | 
learnt that the way to go through Turbo's 
threaded code was to use the "move, jmp” link 
between each template, | immediately tried it out 
on two very short programs with the following 
results. 


Program Number 1 


100 PRINT "noom" 


110 STOP 

| compiled this with options - 1 window 
structured 
include line numbers 
brief 


| discovered that the "move, jmp’ code was at 
$322 from the start of the compiled program and 
set a breakpoint there. All agog | pressed ‘g” to 
set Qmon off! What happened? This happened: 


Action Taken 
"g" pressed 
"g" pressed 


Press Nr Result Seen 
1 No Program yet 
2 No Program yet 
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Program started - window drawn "g" pressed 
4 to 12 No change "ge" pressed 
13 "noom" printed "g" pressed 
14 No change "ge" pressed 
15 No change "g" pressed 
16 Job gone 


Program Number 2 


100 PRINT "noom" 
105 SUSPEND_TASK 200 
110 STOP 


The "move, jmp" code was indeed again at $322 
from the program's start. The 

results were the same as for the previous 
program until after press number 15 

when: 


Press Nr_ Result Seen Action Taken 


16 No change "oe" pressed 
17 No change "go" pressed 
18 Program halted for 200 ticks "go" pressed 
19 No change "go" pressed 
20 Job gone 


It seems that this technique allows you to go 
through Turbo compiled programs skipping the 
templates. | have never yet wanted to do that but 
perhaps the time will come. The problem that | 
had with Turbo was to see what exactly a 
particular template was doing. In my example the 
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template was that for DIMN. | think | would rather 
stay with the second method | suggested than 
calculate how many g's | would have to press 
before | arrived at the DIMN template in the 
program containing it. 


In the examples above there were 16 to 20 
templates. What were they all? 


lt occurred to me that perhaps Simon expected 
me to cut down on the number of threaded code 
templates by using the REM +, - facility to turn on 
and off fast code which does not use templates. 
When | tried to isolate the PRINT command in the 
above examples by this method, | still found that | 
had to step through several sets of threaded 
code (obviously not all of these are turned off by 
the REMs) before | arrived at the PRINT com- 


The new GD2 sprite 
system 


Marcel Kilgus 


With the arrival of SMSQ/E v3 the sprite capabili- 
ties of the PE have been greatly enhanced. 
Applications like the new QD already use high 
colour sprites and some people have wondered 
how those were done and how one can do 
something like that. Well, the first step to get a 
nice sprite is to write Phoebus Dokos and tell 
him what you want ;-) 

Fortunately he did volunteer to do the new JMS 
sprites because neither me nor Bernd Reinhardt, 
who with my help did most of the work of con- 
verting the JMS applications to high colour, are 
really that good graphics designers. If you don't 
have the privilege of a personal graphics guy 
you probably have to fetch your mouse and 
draw the sprites yourself. 

Unfortunately this step is best done on a PC 
because even the simplest applications there are 
far superior to anything SMSQ/E currently offers. 
QD's sprites for example were done in Adobe 
Photoshop. 

Alternatively one can search for a motive on the 
internet or go through various clipart collections. 
In any case the goal is in the end to have a 
graphics file in the PNG file format. 

PNG stands for "portable network graphics” and 
the format got really popular due to patent 
troubles with the established GIF files. Most PC 
applications can read and write it nowadays. The 
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mand. | was only able to determine that | had 
arrived at that command by examining the 
output. Of course by the time | had seen that 
‘noom’ was printed it was too late. | had to restart 
the whole process, this time counting carefully 
through the number of times | had to press g. 


However, | will say that Simon's method combined 
with my MAGENTA% method would have saved a 
few key presses, since | could have jumped from 
the start of MAGENTA% to the code loading the 
next template (which | wanted to investigate). 


Unfortunately | have abandoned the MAGENTA% 
method. 


| have, though, learnt the magic number $322 
which | will bear in mind. Thanks Simon. 


format offers losless compression of the gra- 
phics data in various colour depths and last but 
not least something called an ‘alpha channel’. 

| should probably explain first what this is. QL 
sprites for example have a ‘mask’. The mask 
says what pixel of the rectangular graphics data 
should be drawn on screen and which should be 
left out. This way one can draw graphics objects 
that are not rectangular, like the standard arrow 
sprite. This is called "hard transparency’, which 
simply means that a pixel is either visible or not. 
Now an alpha channel is like a mask but it offers 
more: for every pixel in the graphics data there is 
one value in the alpha channel which can usually 
range from 0 to 255. 0 means ‘pixel is not visible” 
and 255 means "pixel is visible’, just like in a 
mask. The interesting part happens if you chose 
values other than 0 or 255. In this case the sys- 
tem mixes the background pixel with the sprite 
pixel and thus creates a ‘soft transparency’. "10" 
for example means ‘mostly background colour 
with a shade of the sprite data’. The higher the 
value, the more visible the sprite pixel gets. 
Perhaps you have seen a Windows pointer sprite 
that drops a soft shadow on the desktop below. 
In the graphics data this shadow is really just 
black. Only the alpha channel creates the effect 
of a soft blending between the shadow and the 
background. 

As | like eye candy effects | just had to implement 
this into the SMSQ/E graphics drivers and since 
version 3.00 it is available to the public. 

A complete pack with replacement system 
sprites (like the arrow, window move etc.) that 
use the alpha channel for shadows or 


QL foday 


TF Services 


AUK 4-way trailing socket designed to switch off 
computer peripherals automatically when the 
computer is switched off, or (in the case of m ATX 
computer) when it auto-powers down. Compswitch 
has one control socket, and three switched sockets. 
Can be used with lights/hifi/monitors—ie a QL 
monitor can be used as a switch control. 


Cost £24 


r es 


A major hardware upgrade for the QL 
All Hermes features (working serl/2 at 19200, 
independent baud rates/de-bounced keyboard/ 
keyclick) IBM AT kbd I/F // HIGH SPEED RS232 at 
§7600// serial mouse port and 2 other RS232 inputs// 
3 VO lines //, EEPROM 
Cost (including manual/software) £90 (£92/£93) 
IBM AT UK layout Keyboard £11 (£13/£15) 
Serial mouse. 
Capslock/scrollock LED £1 (£1.50/£1.50) 
Keyboard or mouse lead £3 (£3.50/£3.50) 
High speed serial (ser3) lead £4 (£4.50/£4.50) 


Hermes available for £25 (£26/£27) Working ser1/2 and 
independent input, debounced keyboard. 


SuperHermes LITE: All Hermes features (see 
above) + an IBM AT keyboard interface only. 
Cost (incl keyboard lead) £53 (£54/£55) 


Fixed price for unmo 
tested with Thom-EMI rig and ROM software. 
£27 incl 6 month guarantee 


OTHER FEATURES COMMON TO ALL VERSIONS 
DEBUGGED operating system autoboot on reset of power 
failure/ Multiple Basic/ faster scheduler- graphics (within 
10% of lighting) - string handling/ WHEN ERROR/ 2nd 
scree’ TRACE/ non-English keyboard drivers/ “warm” 
fast reset. V1.97 with split OUTPUT baud rates (+ Hermes) 
& built m Multibasic. 

First upgrade free. Otherwise send £3 (+£5 for manual if requd). 

Send disk plus SAE or two IRCs 


MKL..£40 (£41/£43) MKIL..£65 (£66/£67) 


MINERVA RTC (MKID) + battery for 256 bytes ram. 
CRASHPROOF clock & J°C bus for interfacing. Can 
autoboot from battery backed ram. Quick start-up. 


—— DL RomDisg 
Up to 8 mbyte of flash memory for the QL 

A small plug in circuit for the QL’s ROM port (or 
Aurora) giving 2, 4 or 8 mbytes of permanent storage - 
it can be thought of as a portable hard disk on a card, 
and reads at some 2 mbytes per second. 

Think of it - you could fully boot an expanded QL, 
including all drivers/SMSQ etc off RomDisq at hard 
disk speed with only a memory expansion needed. 


2 mbytes RomDisq. £39 (£40/£41) 

4mbytes RomDisq £65(£66/£67) 

8 mbytes RomDisq £98 (£99/£100) 
Aurora adaptor. £3 (£3.50/£4) 


we ME PLANE 
A low profile powered backplane with ROM port 


A three expansion backplane with ROM port included for 
RomDisq etc. Aurora can be fitted in notebook case and 
powered off single 5V rail - contact QBranch for details. Two 
boards (eg Aurora and Gold Card/Super Gold Card/Goldfire 
fixed to base. Suitable for Aurora (ROM accessible from 
outside) & QL motherboard in tower case. Specify ROM 
facing IN towards boards, er OUT towards back of case. 


£34 (£35/£36) 


Connects to Minerva MKII and any Philips PC bus 


Power Driver Interface 16 /O lines with 12 of these usedto 
control 8 current carrying outputs (source and sink capable) 
2 amp (for 8 relays, small motors) £40 (£43/£44) 
4 amp total (for motors etc) £45 (£48/£50) 
Relays (8 3a 12v 2-way mains relays (needs 2a power 
driver) £25 (£28/£29) 
Parallel Interface Gives 16 input/output lines. Can be 
used wherever logic signals are required. £25 (£27/£28) 
Analogue Interface Gives right 8 bit analogue to digital 
inputs (ADC) and two 8 bit digital to analogue outputs 
Q@AC). Used for temp measurements, sound sampling (to 
5 KHz), x/y plotting. £30 (£31/£32) 
Temp probe (-40°C to +125°C) £10 (£10.50/£11) 
£10 (£10.50/£11) 
£2 (£2.50/£3) 
£2 (£2.50/£3) 


Keyboard membrane no longer on sale 
.. £3 (£3. 50/£A4 
ircuit diagr: ae £3 (£3.50/£4 
68008 cpu or 8049 IPC. £8 (£8.50/£9 
8301/8302 or JM ROM or serial lead. £10 £10.50/£11 
Power supply (sea mail overseas) £12 (£19/£23 


Other components (sockets etc) also available 


Prices include postage and packing (Airmail where applicable) Prices are: UK (Europe /Rest of world). Payment by cheque drawn on bank with UK 
address/postal order or CASH! I can no longer accept card payments as UK only does PDQ transaction. SAE or IRC far full list and details 22 Feb D3 


29 Longfield Road, TRING, Herts, HP23 4DG 


Tel: +44 (0) 1442-828254 


Fax/BBS: +44 (0) 1442-82825 


@firshman.co.uk — http://www.firshman.co.uk 
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see-through transparency is available from my 
page at http://www.kilgus.net/smsqe/ 

Look in the "GD2 high colour’ section. The new 
QD toolbar sprites also use transparency if you 
look closely, 

Now, back to the PNG files. In order to create an 
SMSQ/E sprite out of the PNG files you need 
another tool called "SMSQ/E sprite converter’ 
which is also available from my site. It is a Win- 
dows tool, simply because it was much faster to 
program this way. The basic usage of the appli- 
cation should be quite obvious: navigate to the 
PNG file you want to convert, ensure through the 
preview window that you have the right file, hit 
"Convert" and that’s it. There are however a few 


more options that might need some explanation: 


~ iHa png 
=| _hsv.png 


: i |Info. png 
| ame imovepointer. png P 
; |Padlock-ClassicStyle-Notl | 
(0 default |Padlack- New-24Small.pn 
1 Po misc r__Padlock-Newer(Not-surel 
oe i Padlock-Old-Style-Enhanc 


¢ tae = ‘ i " : 
"PNG Files (*,png) x jpontersd.2png ahs 


~Qutput format ~ Colour mode ». Sprite data 

of Assembly © Mode 16 (8 bit Aurora) 

i Binary f Mode 32 (16 bt QPC) Origins [1 » center) fo 
iw ""ExtSep. Mode 64 (32 bit RGB) 

Mi Eaas 

© Bitmask = i ALE compression 

{Alpha [Add shadow 


Output format: the converter can output as- 
sembly source code or a binary file that is direct- 
ly usable as a sprite. You can choose between 
those two here. Also for convenience you can 
say whether the result should have an under- 
score as a file extension seperator or a dot (ie. 
"_spr’ vs “spr’). 

Colour mode: this sets in what format the sprite 
should be saved. You can chose between mode 
16, mode 32 or mode 64. Mode 16 is basically 
the 256 colour mode of the Aurora graphics 
card. The advantage is that in this mode the re- 
Sulting file is small but the downside is that the 
graphics quality can suffer severly. Mode 32 is 
the 16 bit graphics mode of QPC/QXL and is 
often the best choice. Mode 64 is the 32 bit 
graphics mode that doesn't improve image 
quality but heavily increases the file size. 

Sprite data: Here one can give the sprite a name 
which will be used for the labels in the assembly 
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Name (Asm only) [spite 


output. If you chose binary output in the format 
settings the name is ignored. Also you can say 
what origin the sprite should have. Set it to -1 to 
simply center the sprite origin. 

Mask: This is the magic switch that decides whe- 
ther the old hard transparencies should be used 
(‘mask’) or if you want a softer blending into the 
background (‘alpha’). A sprite with a mask is a bit 
quicker to draw compared to an alpha sprite but 
often also bigger in size. 

Extras: Here you can enable the RLE (run length 
encoding) compression which can reduce the 
size of the resulting sprite file. This is also a new 
thing implemented by me into the SMSQ/E gra- 
phics core because high colour sprites can be 
ey huge in memory consumption. The com- 


Isp . pression is not highly efft 


x! cient with every kind of 
| sprite, by far not as good 
| as that used for PNG files, 
but on the other hand it is 
: ‘very fast and pretty easy to 
ls | implement. The downside 
| to using RLE compression 
is only that at the time the 
_ sprite is drawn the system 
/needs a bit more memory 
_and time to first decom- 
| press the sprite data. But 
_ this should hardly be notice- 
. | able. Also there is a switch 
| 


isi Sa xi mens lide 


that when enabled automa- 
| tically computes a soft sha- 
_Convert || dow to the given graphics. 


eta et aren eat eee ~~ This is mostly useful if you 


want to create pointer sprites with a shadow like 
it is known from Windows. 

Now, with this knowledge you should be able to 
create your first high colour sprites. But how can 
the files be used? Well, this is probably worth an 
article of its own. But in principle you can use the 
sprites in the same way like traditional QL sprites. 
EasyMenu for example, although written a long 
time ago, can handle high colour sprites just fine. 
What my converter can't directly create are hy- 
brid sprites that work both in QL and in high 
colour mode. But those are not that difficult to do. 
Basically the high colour sprite just has to be put 
right after the QL sprite and after that at file 
position 20 one has to write the length of the QL 
sprite file minus 20 (as a long word). | think this 
might be a good exercise for my dear readers to 
do (if at this time | still have some). Another thing 
are sprites that change depending on whether 
the menu item is selected or whether the mouse 
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is currently hovering over the item. Those can be 
created using Wolfgang Lenerzs BMP2SPRT 
application, the “competition” to my sprite conver- 
ter It is a very good looking and free SMSQ/E 
application that is certainly worth a look. If is 


available from 


Download 


Launchpad Update 


John Perry 


A few issues ago | wrote about 
the early version of Launchpad 
I'd been using for a very short 
while, and how promising | 
found it despite the inevitable 
bugs and shortcomings of pre- 
release software. Features 
were missing, not fully working 
and poorly documented; de- 
spite that | found it surprisingly 
useable. 

So now that | have been using 
the full release version for a 
while, | thought it time | updated 
my review. | will be writing 
about version 0.96, the most 
recent copy | have been given. 
I'm pleased to say that things 
have only got better! Some 
new features have been added 
as a result of pleas by people 
like me. Some features have 
been enhanced. All the little 
accessory programs are now 
included and working. There's 
a manual. And above all the 
program is now much more 
bug free than the original ver- 
sion | reviewed. Even the Help 
system now works! 

First of all, if you don't like the 
pointer environment, you won't 
want fo use Launchpad. It Is 
pointer driven by its very na- 
ture, it simply won't work with- 
out pointer environment. You 
can CTRL C to SuperBASIC 
and type in commands from 
there in much the same way as 
you can go to DOS from 
Windows and type in com- 
mands from there but that's as 
close as you get. So if you 
arent a pointer environment 
user, stop reading now (unless 
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you want to know what you 
are missing). 

Don't have a mouse? You can 
use Launchpad with cursor 
keys and space bar and enter 
to select items from menus and 
So on but it defeats the object. 
| won't go into the theory of 
Launchpad too much, my origi- 
nal review covers that, enough 
to say that it puts a graphical 
user interface onto QDOS or 
SMSQ. You can set up icons 
and now menus to start or 
‘launch’ programs. You are 
given a few little games and 
other accessory programs and 
a substantial manual to get it all 
going, not that you really need 
it too much. The manual is a 
set of Quill DOC files (also sup- 
plied as plain text files which 
also form the Help files in the 
program). You also get a couple 
of printed sheets as a kind of 
quick-start guide to help you 
install and start the program. 
Things get off to a really bad 
start ~ you get the program on 
two floppy disks. Except it 
won't run from the floppy disks! 
| contacted the author about 
this and he claims it's delibe- 
rate. You have to read the two 
sheets of printed instructions 
and configure the program cor- 
rectly to get it to work. Seems 
the idea is to force you to read 
the instructions before you can 
(abjuse the program. It makes 
sense in some ways | suppose, 
unless you install it correctly, 
you might not get it working at 
all or not get the best results 
from it. To quote the author, if a 


http://www.scp-paulet-lenerz.com/14mljkl24/Wolf/ 


Well, | hope this article gave at least a little insight 
into the new high colour world and | would love 
to see new applications that make use of the 
new possibilities. 


phone call goes along the lines 
of "I've tried running the disks, it 
doesn't work’, he knows the 
user hasn't read the instruc- 
tions. | can see that this would 
potentially be a good thing, but 
it does run the risk of annoying 
customers. 

In actual fact, the configuration 
process is quite simple. You 
simply copy the program to a 
blank disk or to a directory on 
your hard disk and then run the 
CONFIG program to specify 
where it's been installed. If you 
create a directory called 
WINi_LAUNCHPAD_ and put it 
in there, then run config and 
enter that directory name and 
one or two other little details 
and that's it. Apart from editing 
the boot program if you use 
the supplied boot program. All 
easy enough, but think how the 
QL differs from the PC. Insta 
ling a program on a PC under 
Windows usually consists of 
running and installation pro- 
gram, often a little ‘wizard’ pro- 
gram which guides you through 
each step. While the last thing | 
want Is turn my QL into a Win- 
dows machine, | do think there 
are areas in which both Win- 
dows and the QL could learn 
from each other, automatic or 
semi-automatic program instal 
lation is an area where the QL 
could learn from Windows. 
However, Launchpad installation 
is pretty much about as simple 
as most QL software goes and 
this should not be seen as too 
much of a criticism. 

Having installed it, | ran it and 
BANG. A configuration error 
occurred. Oh dear, here we go, | 
thought. Then if occurred to 
me that Id installed the new 
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version over the old version 
rather than deleting the old ver- 
sion first. And the old version 
was a pre-release version. So | 
tried again with a clean instal- 
lation and it worked first time 
Such is the joy of being a soft- 
ware reviewer. | later learned 
that new facilities have been 
added to the program which 
has caused a_ significant 
change to the configuration 
and setup files so the current 
version cannot find some 
information from files created 
on pre-release versions, al- 
though it can cope with confi- 
guration files from more recent 
versions if you upgrade. Basi- 
cally, if you paid for it and later 
update it should work with 
older configuration files by sub- 
Stituting sensible default values 
for any missing items in these 
files. 


When you start the program 
what you get is basically a 
blank white screen. Nothing is 
set up when you first start it, 
you have to set up your own 
program icons or menus. 


And this is one of the biggest 
differences between this and 
the version reviewed. Menus. 
The original version could only 
launch programs via icons 
defined on the desktop. See 
the screen dumps in the 
JulyAugust 2003 issue of QL 
Today to see the program 
icons. | originally wrote that I'd 
like to see a facility akin to the 
Windows START menu, where 
programs are grouped into lists 
and you select which program 
to launch from a menu. Launch- 
pad now has such a facility, 
called LAUNCH or QUICK- 
LAUNCH (surprise surprise!). In 
some way5, it’s lke a Windows 
Start menu (a bit less compre- 
hensive perhaps) with a touch 
of the QL Qascade program 
about it. A little confusingly, the 
menu originally called LAUNCH 
has now been given this new 
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facility, while the old LAUNCH 
menu is now Called UTILITY 
which makes sense once you 
get used to it, as it perhaps 
better describes the facilities 
offered. 

The Launch menu starts as just 
one empty menu. Here you can 
add an item to start a program 
(or anything which can be 
Started by File Info 2 if you use 
that), or add a sub-menu if you 
wish to group programs of the 
same type together Sub- 
menus can contain sub-sub- 
menus and so on, it can get 
pretty complex if you try hard! 
For example, you could create 
a menu called GAMES to put all 
your game programs onto. You 


starts the program if it was a 
program item (or tries to start 
the item via File Info 2 if 
relevant and the item was not 
an executable program). Things 
get a little bit more complicated 
if you do (right click) on one of 
the items in the menu. A new 
menu appears, with options to 
alter the entry, delete it, launch 
it (with various further options!), 
pick that program if it's already 
running, or sort the menu itself 
into alphabetical order Perso- 
nally, I'd like to have seen items 
sort themselves into order 
automatically as they are crea- 
ted, but at least this way you 
have the option of sorting or 


can create a Word Pro- aa, 


cessing menu, | 
databases menu and so 
on to your heart's 
content. Menu names 


can be fairly long, nearly 
as long as QL filenames, 
though certain charac- 
ters are not allowed 
(spaces and underlines 
seem to be allowed so 
you can set up pretty 
meaningful names) since they 
are used as_ internal ag, 
flags, it probably means |"3 
that the few restricted 
characters like arrow 
symbols are used inter- 
nally to signify menu | |; 
names or filenames or |» 
whatever. 

Visually, there is not a lot 
to the Quicklaunch me- 
nus. Figure 1 shows what 
they look like. Basically, a 
white rectangle with the usual 
move and ESC icons at the top, 
a list of programs or menus in 
the middle and three com- 
mands at the bottom to add a 
new program to this menu, add 
a new sub-menu and a little «- 
icon to let you go back to the 
previous menu. A_ hit (left 
mouse click) on an item in this 
menu enters the sub-menu if 
the item was a menu name, or 


not | suppose. 


Figure 1 - The Quicklaunch Menu 


1 2 Menu 3 AES 


Figure 2 - The Quicklaunch 
Menu’'s Action Menu 


All this makes the Quicklaunch 
system seem too complex. In 
fact, a lot of thought has gone 
into this and it only gets as 
complex as you make it. Set- 
ting up the menus initially is a 
bit time consuming but pretty 
Straightforward - you specify 
the filename (you can either 
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type it in or select it from a file 
selection menu), the name 
which appears in the menu 
itself, the job name (so that 
Launchpad can PICK the pro- 
gram, though in most cases it 
automatically extracts this from 
the program by itself, you can 
change this if you know you 
are dealing with a program 
which changes its own name 
as it runs} and a ‘command line’ 
to feed to the program as it 
Starts. For example, this could 
be used to specify which file a 
program is to load as it starts 
up, or to tell some programs 
where to find their own files. 
Like most things in Launchpad, 
it can get as complex as you 
want it to get, simple useage 
generally involves least effort 
Setting it up, complex useage 
takes more time and effort to 
set up. 


Difficult programs are not so 
easy to set up in the Quick- 
launch menus. Desktop icons 
can have DEV SUB, memory 
protection etc etc set up, 
Quicklaunch items can't. So 
programs like Quill which will 
need memory restrictions and 
possibly DEV or SUB settings 
still have to be set up on the 
desktop icons and can't really 
be put in the Quicklaunch sys- 
tem. Not a big restriction (how 
many people still use Quill, Ar- 
chive etc?) 


The hardest part with Quick- 
launch is setting it up in the first 
place. Once set up, it's a dream. 
It seems to handle all the pro- 
grams you could need and 
more (! don't know if there is a 
limit on the number of pro- 
grams or menus it can handle, 
it seems to have coped with 
everything I've thrown at it so 
far!). It doesn't ‘know’ about 
programs, you manually select 
filenames or pick them from 
menus for example, but once 
set up, you just go to the menu 
you want and left click on the 
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name and off it goes. This is 
going to simplify my QLing no 
end! My only gripe is it should 
have been in Launchpad from 
day one! 

A major improvement has been 
made in terms of handling dis- 
play resolutions and colour 
depths. In the early versions, 
you specified resolution and 
colour mode and it made you 
use those settings. If Launch- 
pad decided you wanted to 
use VGA resolution in high co- 
lour mode, no matter what set- 
tings you specified before it 
loaded, it insisted on trying to 
change your computer to what 
it thought you last set in 
Launchpad. Now, it can still do 
this (see it as setting your pre- 
ferred settings) but you can 
also set it to just start up in 
whatever mode you have your 
computer set to. This is not 
always ideal, but it seems to 
manage and I'm sure a lot of 
users will find this a much bet- 
ter way of doing things. 


The Help system is now imple- 
mented, although not quite in 
the way I'd expected. It brings 
up a menu, letting you read the 
relevant instruction file via its 
own text file viewer - basically, 
plain text versions of the ma- 
nuals. The help is not context 
sensitive as it is in a Windows 
system, for example. 


Desktop icons are pretty much 
the same as in the preview 
icon. You can, however, give 
them longer names now. If you 
are using QL screen resolution, 
the names are truncated to 8 
or 9 characters long, while lon- 
ger names are shown on 
higher resolution screens. It is 
still not possible to load your 
own icons, you are still restric- 
ted to the admittedly wide 
range of icons built in. The 
author did say this was some- 
thing others had requested and 
is looking at it for future ver- 
sions, though it would increase 


programming complexity. Since 
you can now use the Quick- 
launch menus to set up most 
programs, you will be putting 
less icons on the desktop than 
you might have done with the 
older releases, so this is less of 
an issue NOW anyway. 

The utility menu has three new 
commands and an enhanced 
Pick facility, 

The Clock command starts a 
digital clock going at the top of 
the Launchpad display. It's a 
simple digital clock like the 
toolkit 2 CLOCK command. 
There are some options to set 
USA or UK and Europe format, 
and whether you show only 
time or date for example. Inter- 
estingly, whatever you set is re- 
membered for the next time 
you start Launchpad. Remov- 
ing the clock is quite easy, just 
choose the command to dis- 
able it. 

Command is for advanced 
users. Put quite simply, it sends 
commands to SuperBASIC or 
SBASIC. It seems to work by 
picking the BASIC interpreter 
and sending the command to 
the command line, optionally 
adding a linefeed to the com- 
mand. For commonly used 
BASIC commands, this can 
Save a lot of time manually se- 
lecting BASIC and typing in 
commands, although a lot of 
users probably won't need to 
use this command. 


Lock is an unusual command. 
Quite simply, if the user con- 
cerned has a password to use 
Launchpad, it will lock every- 
one else out. Possibly useful in 
a workplace, to lock your sys- 
tem while you are away from 
your desk, or if you have 
young kids around who you 
wish to keep their hands off 
your QL while you answer the 
phone! Again, its there for 
anyone who wants such a faci- 
lity my guess is it won't be 
used much. 
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Pick/Remove is an enhanced 
version of the old Pick menu. A 
list of programs running on the 
QL is shown, then you can 
either Pick or Remove that pro- 
gram by selecting the Pick or 
Riob icons at the top then 
selecting the name of the pro- 
gram concerned. Sensibly, it 
defaults to Pick to prevent you 
accidentally stopping a pro- 
gram. Be very careful, | found 
to my cost it can even remove 
Launchpad itself! The list of 
programs includes all running 
programs, not just those star- 
ted by Launchpad. Got to 
BASIC, EXEC a program in the 
traditional way, Launchpad lists 
that program in the menu. It can 
get into some difficulty if the 
program either has no name in 
the JOBS menu or changes its 
name since the menu list was 
displayed. It does have a re- 
fresh icon to update the pro- 
gram name list though. See 
Figure 3 for the Pick/Remove 
Jobs menu. Almost as an after- 
thought, a new menu called 
JOBS has been created which 
just brings up this menu, much 
quicker than going into the 
Utility menu and selecting it 
from there. In fact, switching 
tasks is such a common every- 
day function of Launchpad (QL 
is a multitasking machine after 
all) that 'm surprised it wasn't 
given its own icon at the top of 
the display rather than being 
tucked away on a menu. 


Figure 3 - The Pick/Remove 
Programs Menu 
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The File menu includes a couple 
of new commands. You can add 
a new icon to the desktop with 
the Add New Program com- 
mand, and there is a new com- 
mand to Make Directory on 
level 2 filing systems which sup- 
port the MAKE_DIR command. 
Current versions of Launchpad 
seem to have slightly changed 
the way in which you can right 
click on the desktop. Right click 
on what would have been a 
blank item in early versions 
would have let you install a new 
item, but now you can't right 
click on an empty space to do 
this, but some of the bugs in 
earlier versions seem to have 
been removed as a result of 
tightening up on this. You can still 
do things like the pseudo drag- 
and-drop of icons and so on, but 
the rules on what you can do 
seem to be a bit stricter now. 
The manual is best described 
as ‘long’ and ‘informative’ - writ- 
ten in a matier of fact but helpful 
sort of way. It's divided into 
several parts, and there are 
separate manuals for all the 
accessory programs. | don't 
have strong feelings about the 
manual, apart from perhaps 
thinking that the sheer length of 
all the document files may put 
people off reading them. All the 
information is there. 
There are some _ limitatations 
such as the length of command 
lines you can send to programs. 
In most cases it won't matter 
too much, but might if 
or you are sending com- 
plex command line pa- 
rameters to C com: 
pilers and the like, per- 
haps. 
You are still saddled 
with the same old 
colour scheme (white 
with bits of black, red 
and green) whatever 
mode you run it in. You 
simply dont get a 
choice of colour 
scheme, it wasn't feasible what 
with being written in compiled 


Easyptr basic. 

Launchpad still makes the same 
demands on your system it 
pretty well eats memory 
needing over 300KB just for 
itself, huge by QL program stan- 
dards. Pointer environment. 
toolkit 2 and plenty of memory 
are essential. It does change 
your way of working with QLs 
in many ways and you need to 
be prepared for that. That said, 
it allows you to go into BASIC 
and use your QL as you used 
to in many cases, yet provides 
the convenience and simplicity 
of a GUI interface. It's pretty 
smooth, well put together and 
consistent. It's very different 
from other GUIs Ive used. 
There are touches of Windows 
and one or two other systems 
I've used, yet it’s still quaintly 
unique and has that QL ‘feel’ 
about it - does everything you 
want and more yet still so easy 
to use. 

In summary I'd say this is a solid 
product well worth the 20 
pounds asked for it. It is not so 
radical that it jumps out at you in 
that "must have’ sort of way 
that new technology often 
does, but has that good, solid, 
reliable feel to it, something that 
takes a little bit of getting used 
to yet remarkably simple to 
learn and use despite its size 
and the number of facilities 
offered. It's helped me change 
and modernise the way | look at 
my QL. There are one or two 
areas in which it’s weak, such 
as the lack of colour schemes 
and the lack of ability to create 
and use new icons for program 
launching, but given how much 
the program has already im- 
proved so much during ifs fairly 
short lifetime, I'd hazard a guess 
even these might change in 
time! The author has a 
reputation for writing solid if 
unremarkable programs going 
back to the good old Page 
Designer programs and this is a 
very worthwhile addition to his 
Stable of programs. 


QL loday 


Time To Renew 


The next issue of QL Today will be the last issue of the current volume. 
Volume 9 will start with the May/June issue, as usual. 

Over the last 8 volumes we have had a lot of good cover disks/CDs etc. and we already have some 
things in mind for the upcoming year We are dedicated to providing you with the most up date 
information and we try to keep the mix of articles in the magazine as varied and interesting as 
possible. 

Keeping a good balance is something of an art and we can only achieve it if we have a lot of 
material to choose from. There have been issues where the content has been a bit too technical 
for some of our readers but we always try to make up for this in later ones. Pleasing all our readers 
all of the time is not an easy task. 

With your support, we will soon start volume 9 and ... wouldn't it be nice to be able to celebrate QL 
Today's 10th anniversary in 2005? Although prices for printing and postage have gone up again (as 
every year) we decided to keep the price stable. But we need a bit of help from you. Save us from 
wasting money by having to send out reminders etc. 

We have added a renewal form. Please fill it in and return it a.s.ap. If you choose to pay by credit 
card please use a card which does not expire before April, as we are not going to charge your 
card earlier than April. 

Please also let us know if you do not wish to renew. We will be sorry to see anyone leave but, as a 
‘thank you’ for the magazine in the past, please save us the expense of sending the reminder. 


For German customers: Wenn die jahrliche Verlangerung von QL Today automatisch vom Konto 
abgebucht wird brauchen Sie naturlich nicht anworten - es geht dann automatisch! 


Specifications 


Silver/Blue Led ITX Case 
Electroluminescent Keyboard 
Flat LCD Screen w/ Sound* 

2 IDE channels 

ReWritable CD 

Ethernet Card 

40 Gb Hard Disk** 

Linux AND SMSQ/e*** 


* Optional 
** Size is optional 
*** Can also include QDOS Classic with 

QubIDE 2 ROM if more than 1 HDD is chosen 
Ali Specifications are tentative - Watch QL Today 
for more information soon! 


Qua ntum: Take the power 
Herd ware : back in your hands 
941 Lilac Street #1, Indiana, PA 15701. Email: ql.css@dokos-gr.net 
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Hints and Tips for QPC 


Jochen Merz 


We have received various tips for QPC from a 
number of QPC users. Here is an extract of some 
very useful tips: 


BEEP Problems (1): There have been two 
occasions when the beep in QPC has been quiet. 
On the first occasion | reinstalled QPC, checked 
the configuration was 99 and still no sound. It 
transpired that someone had played with the PC 
and turned the volume down to zero!! 

Recently the same silence fell over my beep. | first 
checked the volume and found it full on. Then | 
noticed that the Volume Control said it was being 
organised by Total Recorder This had been 
added to my system to allow the recording of 
sound from the net. Setting its default sound 
system to the onboard Avance AC97 Audio the 
QPC beep burst back into life. 


BEEP Problems (2): Previous versions of QPC do 
not generate a beep output anymore, although 
older versions did. There is no sound card in the 
PC, the system speaker was used to generate at 
least some kind of audio output on Windows 2000 
and XP systems. BEEP is emulated properly in cur- 
rent QPC versions, but relies on a real soundcard 
to be available in your system. 


Display problems: Under some circumstances on 
some systems, the QPC display turns black (espe- 
cially if run in a window). As long as no windows 
error message Is displayed, you should be able to 
get a proper display back by using CTRL F12 to 
switch to Full Screen mode and another CTRL Fi2 
to switch back to windows mode. 


Floppy disk problems: QL formatted floppy disks 
cannot be read under QPC. They cannot be for- 
matted under QPC either. First, check that the disk 
is not write-protected! Obvious but it happens 
sometimes. DOS/Windows formatted floppy disks 
can be read and written to. So the floppy disk 
drive has to be working in general. 

lf nothing else helps, disable the virus scanner 
when using QL floppy disks. While doing this, do 
not insert floppy disks from other, maybe sus- 
picious sources! As PC virus scanners are not 
aware of a “QL floppy disk format’, some treat 
them as virus infected or unknown disk. The 
results are unpredictable, but a fairly common 
result seems to be in any kind of disk access 
(read, write, format) to be suppressed. 
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Do not forget to turn the virus scanner on after 
you stopped using QL floppy disks! 


Windows/DOS Floppy disks with long names: 
the flexible floppy disk driver written by Tony 
Tebby auto-detects DOS and QDOS floppy disks 
and allows to read and write from and to both. In 
case of a DOS floppy disk, it restricts you to use 
filenames which are accepted by DOS (ie. eight 
characters]. 

For example, flp1_direc_filenametxt written to a 
DOS disk requires a subdirectory ‘direc’ to be 
present, in which the file "filenametxt’ will be 
Stored. 

It wil not allow you to save the file to 
“flol_directory_filenametxt’ (subdirectory is nine 
characters long) or "flpl_verylongfilenametxt’. 
Windows (and more recent DOS versions "under" 
Windows), however, allows you to store long 
filenames and directory names. Under DOS, they 
appear abbreviated by a ~ (tilde) character. 

The question is: can you write to a DOS disk 
using long filenames? The answer is: yes! .. 
configure one of the WIN drives to point to A: (the 
floppy disk) instead of a harddisk. You can do this 
in the QPC configuration dialog or during run-time, 
eg. 

DOS_DRIVE 8,"A:\" 

lf you have a DOS disk inserted, you can try 
DIR DOS8_ 

and you should get a proper directory listing. 
You can now 

SAVE DOS8_verylongname. txt 

and do a DIR again. It worked! 

Now try 

DIR flpi_ 

(which will access the same floppy disk!) ... uh, the 
file is not there! Here comes the SMSQ cache 
system into play.. so in order not to screw up the 
disk contents ALWAYS access the disk ONLY 
through one device, EITHER flol_ or dos8_, but 
never mix them! You can get rid of the cache by 
typing 

DEL_DEFB 

but you have to make sure that you clear the 
cache before every read and write operation 
when you switch the device access. 

However, if you do a 

DIR flp1_ 

now, you should see something like 
verylo~1.txt 


The obvious thing to try is 

FORMAT dos8_ 

but this, unfortunately, report ‘not implemented’. 
Would be nice if this would work, Marcell 
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London Quanta Workshop, 


Jan. 2004 


Roy Wood 


The London Quanta workshop 
was held on a windswept rainy 
Sunday in January and _ that 
may have contributed to the 
scarcity of attendees. It was 
held in the Union Chapel in 
Southwark ~ the same venue 
as the previous year This is 
quite a small hall under a 
church but it is a reasonably 
good venue for the workshop 
and, this time at least, we did 
not have to raise the slum- 
bering Morris Dancers in order 
to be able to get the place set 


up. 


Some of the usual QL traders 
were unable to attend this time 
so Jony Firshman and | were 
the only two to have stalls 
there apart from the Quanta 
stand manned by John and 
Sara Gilpin who had struggled 
down from Manchester for the 
day. In spite of the small num- 
ber of users in attendance 
there were some interesting 
discussion going on. Chris 
Cave was positively chomping 
at the bit (or byte) wanting to 
be able to use the new colour 
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problems reading David Gil- 
liam’s Q40 LINUX disk. There 
was a lot of interest in the Text 
87 patch and in the demonstra- 
tion of the SMSQ/E interface 
with its high colour icons and 


interface for his programs but 30 buttons. 


unable to find a way to 
access them from 'C’. 
He said that there was, 
apparently, aC 
interface for this but it 
had not yet been 
released. | know that 
he will try it out when it 
does arrive so perhaps 
we can persuade him 
to write something for 
the magazine about it. 
At an early stage in the 
day we were asked to 
be quiet for a short 
time SO 
that they 
could hold 
a service in 
the church 
above. If 
| was, at the ~ 
time, demonstrating 
QCoCo to the 
assembled users 
(see Byts of Wood) 
and, having gone 
through 
_ the saga of 
crashes 
/and bugs 
_ they were 
much 
amused to see it crash 
on the first key press. 
(A problem __ that 
Wolfgang Uhlig has 
now solved. Tony, in 
particular, was laughing 
So loudly that he must . 
have disturbed _ their 
Matins. : 
Keith Mitchell was | 
showing off his 17° TFT 


In general it was a pleasant day 
and deserved to have been 
attended by more users. | think 
that next years show should 


maybe be a bit later 


screen and micro | 
computer running 
LINUX and UQLX | 


although we both had — 
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over and the New Year (and 
the QL's 2tst Birthday) on the 
horizon | find myself sitting at 
the keyboard pondering what | 
should be putting into this 
column. It is, after all, fairly 
traditional for there to be a 
retrospective in the first column 
of the new year There are 
quite a few things to remark on 
and quite a few advances have 
been made this last year so | 
suppose we should really start 
there. 


No Ruby Con 


The colour drivers have now 
left us balancing on a delicate 
point. This, to be brutally ho- 
nest, is where the new gene- 
ration of QL emulators and 
hardware waves farewell to the 
old QL. The old black slab is 
not going to run the new 
systems and software in the 
same way that the newer 
hardware and emulators do. |, 
for one, think that the new 
colour schemes and facilities 
are as much a Quantum Leap 
for our Operating System as 
the original QL was in its day 
but there are some users out 
there who still use the old QL 
as a main system. and they 
may be feeling rather left 
behind by the tide of innovation. 
| am often contacted by users 
who still have a standard QL 
with only a Trump Card or, at 
best, Gold Card and who still 
get a great deal of use from 
their systems. To be honest 
about it, if all you want to do is 
to write a few lines of text, 
maintain a small address data- 
base or any other of the more 
mundane aspects of compu- 
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ting, you can do this just as 
well on standard QL as on a 
fast, high powered PC. In some 
cases ~ given the complexity 
of modern software — better. 
For those in the middle position 
of the QL hierarchy the situ- 
ation is somewhat more 
fraught. Moving up to the high 
colour versions of SMSQ/E and 
running them in that mode will 
leave some software non-func- 
tional or working, but unable to 
display the results in a coherent 
or readable fashion. One of 
these was Text 87 which was 
my favourite word processor 
for many years. The patch re- 
leased by Marcel Kilgus has 
changed that for QPC2 and 
high colour QXL users but the 
screen resolution on both the 
Q40/60 and the new Aurora 
colour drivers is different and 
SO it will not work. In the case 
of the Aurora the screen driver 
is limited by the hardware to 
run in the mode it does and the 
reasons for the difference in 
the Q40/60 screen driver are 
mostly due to the way in which 
it was designed and deve- 
loped. These were not some 
conscious effort to be different 
but also made hardware sense 
at the time as far as | can recall. 
Needless to say this is a some- 
what confusing situation for the 
user to be in. 


A Patch on the Original 
While | am on the subject of the 
Text 87 patch | would like to 
say that it is a simple and pain- 
less task patching the main 
program to work in High Colour 
mode and the different colour 
scheme on offer is very good. 
lf there are Q40/Q60 and 


Aurora users out there who 
would like to have the patch for 
their system they should con- 
tact Marcel who says he will 
undertake the task if there is 
enough interest. 


The Up Gradient 


What most of the above means 
Is that, if you upgrade your 
SMSQ/E to that latest version 
and you want it to run using the 
high colour mode, then you 
have to upgrade the other pro- 
grams that you use as well 
Many of the older programs will 
work perfectly well under the 
high colour mode SMSQ/E but 
some have display problems 
and need upgrading. One pro- 
gram that does need to be 
changed is Sysmon but that 
has been the case since Mar- 
cel changed the memory map- 
ping. 

The new colour schemes allow 
a much more ‘modern’ looking 
system and you will not get the 
full effect of the changes with- 
out upgrading the programs. 
Luckily most of these upgrades 
are pretty cheap so the overall 
cost to the user is not high and 
end result is a much better 
interface. Some programs are 
still awaiting changes but the 
ones | have in use are greatly 
improved by the new ‘ook’. 


Open Source Does the 
Business 

A report out recently sugges- 
ted that the business communi- 
ty is waking up to the realities 
of the Linux world, although 
the sources for the report were 
un-named and could, therefore 
be regarded as suspicious. The 
suggestion was that, while the 
companies saved money on 
the purchase of software, the 
eventual cost of re-training, pro- 
ductivity loss due to unfamiliar 
interfaces, data file incompatibi- 
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lity with other more main- 
stream, software and other fac- 
tors outweighed the saving. It 
states that the purchase price 
is only 10% of the ‘Total Cost of 
Ownership’ and the larger the 
company the bigger the down- 
Side of switchover. The reason | 
bring this up here is_ that 
another part of the report talks 
about adapting open source 
software. 


The ability to modify software 
to your Own purposes and fix 
bugs is an attractive proposi- 
tion, especially when larger 
software houses are slow at 
responding to bug reports and 
ignore requests from day to 
day users. It does, of course, 
presuppose that you have the 
ability and knowledge to do 
this. 


It goes on to mention that, 
once you have made these 
changes and submitted them 
to the ruling body of the 
software, your particular modifi- 
cations may not be implemen- 
ted and, perhaps, a conflicting 
piece of code may be incorpo- 
rated in the next release ren- 
dering all of your work worth- 
less, or even worse, destruc- 
tive. If you persist with your 
own version, and there is 
nothing in the rules that says 
you cannot, you have then a 
‘fork’ in the code. It somehow 
struck a chord with me regar- 
ding the debate on the open 
source nature of SMSQ/E and 
it was interesting to see that 
the commercial world probably 
spent a fortune on consultants 
to produce a report saying 
pretty much what we decided 
when the debate was raging. 
The chances of many ‘forks’ in 
our system are pretty low 
given the smaller user base 
but what is true of the macro- 
cosm is also relevant to the 
microcosm. 


| also received an email from 
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Duncan Neithercut (more on 
him later) who said he was very 
pleased with the way the 
SMSQ/E had developed since 
the licence. This made me think 
that, after the furore when the 
licence was being thrashed out 
| had heard no words of com- 
plaint and many of praise for 
the course the system had 
taken (OK so a few of those 
came from me but that is my 
purpose in writing these co- 
lumns. | do try to say what | 
think and to keep this column's 
views as separate from the 
‘commercial _ activities —_of 
QBranch as possible) On the 
whole | would say that 2003 
had shown that our decision to 
keep a strict licensing position 
and maintain the code in the 
way we do has bourne a lot of 
fruit and | sincerely hope that 
2004 will see even further de- 
velopment. 


Flash - Is He Going to 


Save the World? 


While he was chatting Duncan 
told me he was working on 
some code to allow the Q40/ 
Q60 to read FAT formatted 
Compact Flash disks. Now 
don't all jump at once because 
this is on the drawing board 
and may be a long way off 
being completed but he did say 
he had limited function already, 
This would be a good develop- 
ment since it would allow QPC2 
users to write a QXLWIN file to 
compact flash using one of the 
many adaptors available for 
their PC and then transport the 
contents onto their Q40/Q60 in 
one go. Since | recently rebuilt 
a Q40 system here | would 
have found that to be a very 
useful utility The Compact 
Flash disk would then be a 
Super Floppy Disk 

You may be surprised that | re- 
built the Q40 | had here but the 
reason is that formatting and 


copying to floppy drives on the 
PC under QPC2 is so slow. This 
is not a fault of QPC2 but a 
result of the dreadful interface 
between the PC and the Flop- 
py drives. Most of the physical 
components of the PC/Floppy 
/O have not changed in 10 
years and, as | mentioned be- 
fore, many Floppy cables still 
have the old 5.25” Floppy con- 
nector on the them. | found | 
was wasting a lot of time at 
shows just writing the disks so 
i brought the Q40 back into 
play. | also needed to try out 
the new version of SMSQ/E 
before release. 


QL2004 


Last year there was much talk 
of a large QL Workshop being 
held a some point this year to 
commemorate the 20th anni- 
versary of the release of the 
QL. Many of us thought that 
this would be a good thing and 
there was a questionaire inser- 
ted into the magazine to ask 
where people would like this to 
be held. Well we are now in 
2004 (in case you had not 
noticed) and no venue or date 
has been announced. The inde- 
cision about the event has 
caused a few problems. | usual- 
ly organise a workshop in 
Hove. This has, for the past five 
years, been held early in the 
year but the London show 
being held in January meant 
that | was forced to re-think the 
date and now | am not sure 
when the QL2004 show will be 
so | have no idea what date to 
aim at. 

Geoff Wicks has been pushing 
for a decision on this for some 
time and was one of those 
who wanted the show to be 
held in Eindhoven so that the 
European users would be able 
to visit as well. On reflection | 
would say that many of the UK 
users are a bit older than their 
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continental counterparts and 
they would be unlikely to un- 
dertake a journey across the 
channel but Geoff has also 
proposed two shows being 
held. One in Eindhoven and one 
in the UK and this may be the 
best bet. 

| would be very willing to at- 
tend both shows (provided the 
dates do not clash with other 
things) but we do need a deci- 
sion soon to allow time to plan. 
And talking of planning ahead 
here is a new feature for this 


Old Wood’s Almanac 
(Predictions For This Coming 
Year) 


February: Marcel Kilgus is 
found unconscious after a 
freak accident with a super fast 
version of QPC2. When he re- 
covers consciousness he says 
he renounces all forms of com- 
puting, fast food and fizzy 
drinks. Goes to Tibet to train as 
a monk. 


March: Dilwyn Jones, inspired 
by Arnold Schwarzenegger 
takes a body building course 
and gets elected President of 
Wales. Immediately declares all 
PCs illegal. 


April: The EU declares Darren 
Brannagh's house an EU QL 
mountain and makes it an area 
of outstanding binary. QLs are 
declared an endangered spe- 
cies and no-one is allowed to 
throw one away. 


May: Quanta receives a letter 
from Bill Gates saying that he is 
So impressed with the way the 
QL has lasted for 20 years that 
he is giving half the profits of 
his company to Quanta to use 
how they want. Robin Barker 
buys a stretch Limousine and 
takes the committee out for a 
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slap up meal before booking 
the Albert Hall for QL 2004 


June: QL DVD walks away with 
multiple Oscars. Steve Rayel 
for ‘Best Director in a film fea- 
turing QLs’, Mplane for ‘Best 
supporting role’ and Bill Ri- 
chardson for ‘Best Newcomer’ 


July: The QL has a birthday 
party and wakes up the next 
morning with a hangover, in bed 
with an Atari ST Its volatile 
memory is erased. Will it ever 
know if... 


August: Tony Firshman enters 
the Tour de France riding a 
bicycle with a special ‘Hermes’ 
saddle designed to stop ‘bum 
bounce’ and give a_ faster 
throughput. 


September: Quanta learns that 
the Bill Gates in question is 
William Eustache Gates and the 
company he owns is a wet fish 
emporium in Skelmersdale. To- 
tal profits for 2003 were £10 3s 
6d in old money. Oops! 


October: Chinese authorities, 
realising they manufacture 90% 
of the worlds motherboards 
and other computer compo- 
nents, change their calendar 
and declare this to be the ‘Year 
of the Mouse’. They immediate- 
ly come down with Repetitive 
Strain Injury and have to rest up 
for a while. 


November: A particularly nasty 
computer virus wipes out 98% 
of the worlds computers and 
the internet stutters to a halt. 
Hordes of bleary eyes, white 
skinned gamers emerge, 
blinking into the daylight and 
spontaneously combust due to 
the exposure to the sun's rays. 
In desperation the world's go- 
vernments fund Nasta's ‘Super 
QL’ project and, using Jonathan 


Dent's TCP/IP and_ internet 
software rebuild the Internet 
better than it was before. 


December: Marcel Kilgus is 
struck by Lightning whilst rin- 
ging the prayer bell in the Hima- 
layas. He is rushed back to 
Germany unconscious and 
when he comes round he 
writes a 32 bit colour version of 
QPC2 for a Woolworths 
pocket calculator and goes out 
with the other traders for a 
meal during which he con- 
sumes a large Pizza and a 
bucket of Coke. Reclusive QL 
user dies and leaves Quanta 
£45 million. Robin is released 
from debtors prison. Normality 
is restored and the QL world 
has a joyful Christmas. 


Honourable Mentions 


in Despatches 

The first accolade of the year 
is long overdue and goes to 
someone who had the task of 
writing a new colour configura: 
tion tool thrust upon him. Wolf- 
gang Uhlig accepted this with a 
good grace and went on to 
produce what s, definitely, one 
of the best looking and most 
functional QL Tools | have seen. 
As the person who nominated 
him for this role | have been the 
recipient of most of the beta 
versions so | have watched it 
develop from a lot of ‘Not im- 
plemented yet’ messages to a 
fully functioning program. It 
uses windows and buttons to 
display the various items that 
can be changed and these 
then change to the colours 
selected by the user so, for 
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THE LAUNCHPAD IS NOW 
READY FOR TAKE-OFF... 


An all-new graphical user interface for QDOS 
or SMSQ/E from Dilwyn Jones. Fed up of 
+ BASIE Rep Convert Easymens YeageFroc typing in EXEC ‘filename’? With this pointer 
Ls oD Mos 7 S & driven application, simply set up desktop 
ry] ra Si er a icons to launch programs, or create menus or 
Rppttonage penis Fis Find. Lasts “lists” of programs to launch, all in a simple 
eo 2, Sa =, to use no-nonsense graphical “point and 
wa & @ click” system — use with mouse or keyboard. 
a Runs on anything from expanded memory QL 
to QPC2 or Q60, as long as you have pointer 
environment and Toolkit 2 


ts) 


a: 


Heh & 


Set up icons for launching your programs with 

a single mouse click from one of four desktop 

surfaces 

Set up your own program launching menu 

Up to 16 users, all with optional passwords 

MyQL menu to customise and remember your 

QL settings for each user : 
Runs as a simple job, does not prevent you : 
using BASIC oi ain else : : “=e ia m a8 eal Pite ho 
Several accessory programs (calculator, Ss a os 
calendar, screen saver, file handler, games and eee Ser eRe” Srey Y 


Gascade- 

Spreadsheet+ r 
so on) Se A | een, 
Revolutionise your QL system — you’ il ao &€ ¢& ww 
wonder how you managed without it! Reena «ines. Diet rey keine 


a Be 


BASIC Conv-PCX EasyBase HTML Nach 


THE QL CD-ROMs ARE STILL AVAILABLE... 


QL Emulators CD £5.00 - QL Documentation CD £5.00 - QL PD-CDR £5.00 
QL PD Library CD £10.00 - QL Religion CD £10.00 - QL Literature CD £10.00 
Line Design Clipart CD £10.00 - Famous Faces Clipart CD for Line Design £10.00 
PD Software Library catalogue available on my website http://homepages.tesco.net/dilwyn.jones/index. html 


Want To Know More? 


Visit the Launchpad web page at: 
http://homepages.tesco.net/dilwyn.jones/launchpad/launchpad.html 
from where you can download a free trial version, limited only by the number of programs 
you can set up to run on it - more than enough to try out Launchpad. 


Launchpad is available (price £20.00) from either the author: 
Dilwyn Jones, 41 Bro Emrys, Tal-y-bont, Bangor, Gwynedd, LL57 3 YT, U.K. 
email: dilwyn.jones@tesco.net Payment in Pounds Sterling only 
or from: 
Q-CELT COMPUTING, 
The Falconry, Glenmacnass, Glendalough, Co. Wicklow, Ireland 


email: darrenb@esatlink.com (Payment in Pounds Sterling or Euros) 
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those items which do not need 
to be completely refreshed the 
result is instant. Many of the 
ideas for this are quite innova- 
tive and are better implemen- 
ted on the QL than on other 
systems | have seen. Similar 
programs under Windoze allow 
the user to select a colour from 
a swathe of different colours 
but Wolfgang's program, lead- 
ing on from his original ‘Colour 
Tools’ of a couple of years ago, 
actually allows you to modify 
the end result in three different 
areas, hue, brightness and 
saturation. Using these three 
criteria you can create any 
number of different shades and 
colours. These can then be 
stored in a ‘My Favourite 
Colours’ Bar which allows you 
to re-use the colour on another 
item. The Micr$oft version 
does not allow this and you 
have to re-select the colour 
each time. Bonus for the QL 
ingenuity. 

The results of your labours can 
be saved as a ‘Theme’ which 
can then be loaded in the boot 
file or at any other time during 
the computer's use. There is a 
button which will allow you to 
make the theme you are 
working on the current one so 
you can see the effects on the 
programs you use. Another 
neat idea is the inclusion of a 
‘Synchronise’ button which will 
offer to choose colours to fit 
those which you have just 
changed. This makes a cohe- 
rent Theme’ easier to produce. 
All in all | have been very im- 
pressed with the way the pro- 
gram looks and the large 
amount of work he has ob- 
viously put into it. | hope that he 
will find the time to produce 
some more programs for us. 


Oh, and by the way, it is free! 
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You can download it from: 
http://www.uhlich.nl/qi/index.htm 


| can feel a competition coming 
on - best ‘Theme’ anyone? 


Wolfgang deserves a lot of 
praise for the innovative way 
he has tackled the task and a 
massive ‘Thank you’ from the 
SMSQ/E community for his 


A Bugs Life 


As an aside to this | would like 
to put myself forward for ‘Big 
slap on the wrist - must be 
more methodical’ prize. 

Wolfgang sent me several ver- 
sions of this program and, as | 
said they all got better with 
each new version. Shortly be- 
fore the London show | got a 
Final Release version’. This 
seemed to work well and | 
started to put together a disk 
with all of the colour stuff on it 
Then | found a bug. | clicked on 
one of the menus chose to 
change the colour and, bang ! 
Red Qlip screen! Okay | con- 
tacted Wolfgang. ‘No works 
here’ was the reply. We deci- 
ded it had to be something in 
my BOOT file being loaded 
which stopped it working. Fire it 
up with a small BOOT file. It 
works. OK must be an exten- 
sion. | spent an entire evening 
deleting lines from the BOOT. 
Every now and then | got it to 
work and sent an excited email 
to Wolfgang saying | had found 
the problem only to find that 
the next time it did not work. 
Finally | worked it out. The pro- 
gram has two distinct sets of 
buttons, one on the right and 
one on the left. The left hand 
ones work on the big items like 
Application Windows — and 
Menus. The ones on the right 
work on smaller items like 


Scroll Bars Buttons etc. They 
both call the same colour con- 
figuration windows but the rou- 
tines that call them and return 
the values are different. The 
ones on the left worked and 
the ones on the right didn't. 

lt was that simple. | had just 
fired it up and chosen an item 
at random thinking that the bug 
was in the colour selection. As 
soon as | had told Wolfgang 
about this he reproduced the 
bug and solved it - and 
promptly introduced another 
one. This was, by this time, 
Saturday afternoon before the 
London show where | wanted 
to give away disks and demon- 
strate the program. Frantic 
emails passed between us until 
we finally had a working ver- 
sion of the program —- all bugs 
expunged. 

While my machine booted up | 
told Tony Firshman, Keith 
Mitchell and other assorted 
people at the show the story 
and said you will see some- 
thing brilliant! | fired up the 
program and said ‘When | did 
this last night it crashed but 
Wolfgang has fixed it and...’ 
bang it crashed! Tony was 
apoplectic with laughter | had 
managed to find the one re- 
maining bit of code that had not 
been fixed with the first click 
and in front of an audience. 
serves me right eh? 


One Last Thought 
Someone told me a joke re- 
cently and | thought it would 
work well adapted for the QL 
traders and programmers: 


Q: How do you become a 
Millionaire dealing in QL soft- 
ware? 

A: Start off as a Billionaire. 


Have a Happy and Preposte- 
rous New Year! 
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QL 2004 


Geoff Wicks 


Last year’s QL Today poll on the 
venue for QL2004 proved to be 
almost as close and controver- 
sial as the last American presi- 
dential election, but without 
hanging and pregnant chads to 
reduce the tension. The QL 
community was divided with the 
continentals wanting the show 
in Eindhoven and the UK-ers 
wanting it in the UK. It made 
grim reading for an organiser, 
because, whatever he did, he 
was likely to upset half of the 
QL community. 

After the poll an eerie silence 
descended on plans for 
QL2004. | had hoped that at the 
Byfleet show there would be 
some information, but instead 
there was confusion. People 
who had attended the show 
told different stories about 
QL2004 plans. 

| am a QL2004 maverick. Al- 
though | live in the UK, | firmly 
believe the continent should 
have the show. The UK ran 
QL2000 and now it is the conti- 
nent’s turn. Also the centre of 
QL development has moved 
from the UK onto the continent 
and, in particular, Germany, 

On New Year's Eve | asked for 
reaction from the QL-users 


from QUANTA. | took this to 
mean that should there be a 
clash between QL2004 (UK) 
and QL2004 (Eindhoven) nego- 
tiation was possible. 

There was a green light for 
QL2004 (Eindhoven), but please 


Eindhoven is an ideal setting for 
a continental QL2004, because 
it is readily accessible from the 
etherlands, Belgium and North 
Germany. It is also within easy 
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traveling distance of France, 
South Germany, Austria, Italy, 
Switzerland and the UK. In the 
past Eindhoven was well known 
for its international QL shows at 
the Pleincollege St. Joris, a se- 
condary school with ample facili- 
ties for a large group of people. 
The local user group, Sin-QL-Air, 
obviously need the time to dis- 
cuss the possibility of hosting 
QL2004 especially as they are 
now a fairly small group. We 
have also given them short no- 
tice of our wish to hold the 
show in Eindhoven. Obviously 
there are many practical pro- 
blems we have to discuss with 
Sin-QL-Air but if QL2004 goes 
ahead it will be held on a Sa- 
turday in October or November. 
Sin-QL-Air have already sug- 
gested a possible date, but this 
date was not possible for 
Jochen. 

QL2000 was a luxury show that 
is reputed to have cost 
QUANTA over £2,000, but we 
have to organise QL2004 with- 
out financial backing, which 
means that we have to be rea- 
listic about the possibilities and 
limitations. Fortunately the loca- 
tion will cost us nothing. Re- 
freshments will have to be self- 
financing, and how lavish these 
can be is still to be negotiated. 
There will be no organised 
program for spouses and other 
guests, but the Netherlands is 
full of historic towns within easy 
reach of Eindhoven. We have, 
as yet, no plans for an official 
show dinner, but there is a long 
after-show tradition of a visit to 
a Chinese restaurant. 

What can you expect of 
QL2004? We want this to be a 
nostalgia show to which we 
invite ex QL friends for a re- 
union. This theme was inspired 
by a group of Scandinavians 
who replied to my New Year's 
Eve email. They are no longer 
active QL-ers, but they wanted 
an opportunity to meet old QL 
friends. We want to show ex- 
QL colleagues how far the QL 


has advanced in the last few 
years. This means plenty o 
Q60s and QPCs running pro- 
grams in the new colours, but 
also, Wolfgang Lenerz has sug- 
gested, some black boxes to 
remind people of how we star- 
ted. Maybe existing QL-ers also 
need a morale boost to remind 
us we are a viable force with 
olenty to boast about. 

Initial reactions from QL-ers indi- 
cate they want a program of 
lectures and demonstrations. 
Jon Dent has suggested an 
internet connection workshop 
dealing with registering with an 
ISP and emailing from your QL - 
a good follow up to the theme 
on the last day of QL2000. If it is 
technically possible we could 
consider some form of internet 
linkup with QL-ers around the 
world. 

| would like QL2004 to become 
a ‘Peoples’ Festival’ with a de- 
monstration program that could 
change as the day progresses, 
but we also need items to form | 
a basis program. Any sugges- = 
tions for these would be wel 
come. We also need you to 
contacting your old QL friends 
and bring them along. 

There are still many uncertain- 
ties over QL2004 and logistical 
problems to be overcome, but | 
hope many of these will be 
solved by the time you are 
reading this, and that we can 
give more concrete details in 
the next QL Today. 

And UK QL-ers? If you also wish 

to have a QL2004 event you 
could organise a similar themed 
event without too many clashes 
with Eindhoven, but | have 
another suggestion. Why not 
think about QL2005? What 
about a huge QL 21st Birthday 
celebration in the weekend 
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15/16th January 2005? Perhaps 
a social event rather than a 
traditional workshop? And don't 
forget the UK birthday tradition. 
Who will provide the birthday 
cake and which celebrity will 
blow out the 21 candles? 


) The QL Show Agenda ¢ 


Se 


AGM _& Quanta Workshop - Manchester (UK) 


Saturday, 17th of April, from 1:00 pm and 

Sunday, 18th of April, 9:30am to 3:00pm 
NEMQLUG organises the show 

at the traditional Manchester venue: : 

3rd Davyhulme Scout Headquarters / 

Conway Road, Davyhulme, Manchester e 


There will be a celebratory 21st dinner on Saturday night, deposit of 
£10.00 required by 15th March 2004. 


Talks have been arranged on the latest hardware/software developments 


Hotels: Coach House Travel Inn, 
Trafford Centre, Tel. 0161 747 8850 
Mersey Farm Travel Inn, Carrington, Tel. 08710 977179 


The Scout HQ. is located close to Junctions 9 and 10 off the M60, 
formerly Junctions 4 and 3 off the M63. 


US QL Show 2004, Orlando, Florida (USA) 
Sat/Sun., 24/25th of April 


Quanta and NASQLUG are pleased to announce the US QL show to be held 24/25 April 2004 
Saturday 10 AM to 5 PM and Sunday 10 AM to 3 PM 
at the Days Inn International Drive, 7200 International Dr Orlando, FL 32819. 
Phone: 407-351-1200, Toll-Free in US: 800-224-5057, Fax: 407-363-1182. _ 
Their room rate is $49.95 per night for 1 to 4 persons (contact Diane at the hotel directly for this } 
price). (Plus 11.5% tax). However, rates as low as $35.95 are available at Discount Hotels and Resorts | 
US phone (800) 479-1406 or wwwdiscounthotels.cc Make sure to specify Days Inn at 7200] 
International Drive since there is another Days Inn on International Drive. 


For more details see last page of previous QL Today issue or visit the website dedicated to the E 
USA show by Jim Hunkins: y 


http:/www.jdh-stech.com/ql-usashow.htm 


